Answers and account

Get the answer of a job

OpenAPI JSON llms.txt Markdown

Fetch the answer of a job. Poll about once per second until the job is ready.

On this page

Authorization
Path parameters
Query parameters
Response
200 OK
Errors
Notes

GEThttps://api.solvecha.com/v1/recognition/{type}

Returns the answer of a job that you created before. Use the same captcha type in the path as when you created the job. While the job is not ready, the response is error 14 (HTTP 409): wait one second and ask again.

#Authorization

Send your API key as Authorization: Bearer YOUR_API_KEY. Other ways are the key field of the body and the key query parameter. See Authentication.

#Path parameters

Name	Type	Required	Description
`type`	string	required	The captcha type of the job. One of `recaptcha`, `textcaptcha`, `geetest`, `funcaptcha`, `funcaptcha_match`.

#Query parameters

Name	Type	Required	Description
`id`	string	required	The job id from the create response. Up to 64 characters.
`key`	string	optional	Your API key, if you do not send it in the `Authorization` header.

#Response

#200 OK

The job is ready. The shape of data depends on the captcha type. Each type page shows it.

#Errors

An error has the HTTP status of its code and the body shown in the response examples:

Code	HTTP status	When
`14` Incomplete job	409	The job is not ready yet. Poll again in one second.
`10` Invalid request	400	The id is missing or unknown, or the job has another captcha type than the path.
`11` Rate limit reached	429	Your key is above the poll requests per minute of its plan (20 times the create limit).
`15` Invalid key	401	The key is missing, malformed or unknown.
`9` Unknown error	500	Server error. Retry after a few seconds.

All codes are on the Errors page.

#Notes

A job is charged once, when the first poll returns the answer. Polling the same job again never charges twice. Only answers count against your quota.

Request

cURL

curl "https://api.solvecha.com/v1/recognition/recaptcha?id=1234567" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://api.solvecha.com/v1/recognition/recaptcha?id=1234567",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.status_code, response.json())

Node.js

const response = await fetch("https://api.solvecha.com/v1/recognition/recaptcha?id=1234567", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
console.log(response.status, await response.json());

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.solvecha.com/v1/recognition/recaptcha?id=1234567", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(out))
}

Response

200 OK

{"data": [false, true, false, true, true, false, false, false, false]}

409

{
  "error": 14,
  "code": 14,
  "message": "Incomplete job",
  "type": null
}

400

{
  "error": 10,
  "code": 10,
  "message": "Invalid request",
  "type": null
}

429

{
  "error": 11,
  "code": 11,
  "message": "Rate limit reached",
  "type": null
}

401

{
  "error": 15,
  "code": 15,
  "message": "Invalid key",
  "type": null
}

500

{
  "error": 9,
  "code": 9,
  "message": "Unknown error",
  "type": null
}

Solvecha is an independent service. It is not affiliated with NopeCHA, 2Captcha, CapSolver, Google or CloakHQ. Their names describe compatibility or recommendations only. Figures come from our own tests, see the compare page.