GET /api/:id — Get Result

Poll for the result of a submitted task.

Endpoint

GET https://api.ucaptcha.net/api/:id

Replace :id with the captcha value returned by POST /api.

Authentication

Pass your API key via authtoken query param or HTTP Basic auth.

Responses

Still Processing

{
  "captcha": "TASK_ID",
  "is_correct": true,
  "solved": false,
  "text": ""
}

Solved

{
  "captcha": "TASK_ID",
  "is_correct": true,
  "solved": true,
  "text": "03AGdBq24PBCbwiDRkh3FOcMZ..."
}

The text field contains the solution — a token string for token-based CAPTCHAs, or recognized text for image tasks.

Failed

{
  "captcha": "TASK_ID",
  "is_correct": false,
  "solved": true,
  "text": "",
  "error": "Task failed"
}

Not Found

{
  "captcha": "TASK_ID",
  "is_correct": false,
  "solved": false,
  "text": ""
}

Response Fields

Field	Type	Description
`captcha`	string	Task ID
`is_correct`	boolean	`true` if the solution is believed correct
`solved`	boolean	`true` when the task has finished (success or failure)
`text`	string	Solution token/text (empty until solved)
`error`	string	Error message (only present on failure)

Examples

cURL

curl https://api.ucaptcha.net/api/550e8400-e29b-41d4-a716-446655440000

Python Polling Loop

import requests
import time

task_id = "550e8400-e29b-41d4-a716-446655440000"

while True:
    result = requests.get(f"https://api.ucaptcha.net/api/{task_id}").json()

    if result["solved"] and result["is_correct"]:
        print("Token:", result["text"])
        break
    elif result["solved"] and not result["is_correct"]:
        print("Failed:", result.get("error"))
        break

    time.sleep(3)