# Noptcha > Noptcha is a captcha solving API at https://api.noptcha.com. It has two APIs sharing keys, prices and tasks: an anti-captcha compatible JSON protocol (POST /createTask, then poll POST /getTaskResult; key in the clientKey body field; every response is HTTP 200 with errorId/errorCode) and a native REST API under /v1/ (POST /v1/tasks with "Prefer: wait=N" to wait up to 90 s, Idempotency-Key for safe retries, Authorization: Bearer , RFC 9457 errors). A 2captcha-style in.php/res.php endpoint exists for legacy clients. Keys start with nop_live_ (charged) or nop_test_ (free sandbox with fixed answers). Only solved tasks are charged. - OpenAPI 3.1: https://noptcha.com/openapi.json (YAML: https://noptcha.com/openapi.yaml) - Task parameter JSON Schemas: https://noptcha.com/schemas/.params.json, e.g. https://noptcha.com/schemas/recaptcha.v2.params.json - Full text of these docs: https://noptcha.com/llms-full.txt - Every page is also available as Markdown: add .md to the path (e.g. https://noptcha.com/docs/quickstart.md) ## Get started - [Introduction](https://noptcha.com/docs.md): What the Noptcha API does, its two APIs, and where to start. - [Quickstart](https://noptcha.com/docs/quickstart.md): Solve a first captcha task with a free Noptcha test key, using the compatibility API or the native v1 API, in curl, Python or Node.js. - [SDKs](https://noptcha.com/docs/sdks.md): The official Noptcha client libraries for Python and Node.js / TypeScript - solve a captcha in one call, typed errors, webhook verification. - [Keys and authentication](https://noptcha.com/docs/authentication.md): Noptcha API keys (nop_live_ and nop_test_), where to send them, scopes and restrictions. - [Sandbox (test keys)](https://noptcha.com/docs/sandbox.md): Noptcha test keys (nop_test_) return fixed answers without charges; magic values simulate failures, timeouts, proxy errors and slow tasks. ## APIs - [Compatibility API](https://noptcha.com/docs/compatibility-api.md): The anti-captcha compatible JSON protocol of the Noptcha API - createTask, getTaskResult, getBalance and reports - and how it differs. - [Native API (v1)](https://noptcha.com/docs/native-api.md): The Noptcha REST API under /v1/ - authentication, conventions, the task object, errors and the list of endpoints. - [v1: tasks](https://noptcha.com/docs/native-api/tasks.md): Create tasks with the Noptcha v1 API - synchronous waiting with Prefer, idempotency keys, metadata, long polling and feedback. - [v1: account](https://noptcha.com/docs/native-api/account.md): Balance, task types and prices, key information and usage reports in the Noptcha v1 API. - [2captcha legacy API](https://noptcha.com/docs/2captcha-api.md): Use software written for the 2captcha in.php / res.php protocol with Noptcha - supported methods, responses, error codes and differences. - [Webhooks](https://noptcha.com/docs/webhooks.md): Get a task's final result and account events POSTed to your server. Callback URLs and console endpoints, event payloads, signature verification in Python, Node.js and Go, retries and limits. ## Task types - [Task types](https://noptcha.com/docs/task-types.md): Every captcha type the Noptcha API solves, with its v1 type name and compatibility API names. - [Proxies](https://noptcha.com/docs/proxies.md): How to pass a proxy with a Noptcha task, which types need one, and how proxy credentials are handled. - [Cloudflare challenge page](https://noptcha.com/docs/task-types/cloudflare-challenge.md): Solve Cloudflare challenge page with the Noptcha API: type cloudflare.challenge, parameters, solution fields, compatibility names and runnable examples. - [FunCaptcha (Arkose Labs)](https://noptcha.com/docs/task-types/funcaptcha.md): Solve FunCaptcha (Arkose Labs) with the Noptcha API: type funcaptcha, parameters, solution fields, compatibility names and runnable examples. - [hCaptcha](https://noptcha.com/docs/task-types/hcaptcha.md): Solve hCaptcha with the Noptcha API: type hcaptcha, parameters, solution fields, compatibility names and runnable examples. - [FunCaptcha image](https://noptcha.com/docs/task-types/image-funcaptcha.md): Solve FunCaptcha image with the Noptcha API: type image.funcaptcha, parameters, solution fields, compatibility names and runnable examples. - [AWS WAF image grid](https://noptcha.com/docs/task-types/image-grid-aws.md): Solve AWS WAF image grid with the Noptcha API: type image.grid.aws, parameters, solution fields, compatibility names and runnable examples. - [hCaptcha image grid](https://noptcha.com/docs/task-types/image-grid-hcaptcha.md): Solve hCaptcha image grid with the Noptcha API: type image.grid.hcaptcha, parameters, solution fields, compatibility names and runnable examples. - [reCAPTCHA image grid](https://noptcha.com/docs/task-types/image-grid-recaptcha.md): Solve reCAPTCHA image grid with the Noptcha API: type image.grid.recaptcha, parameters, solution fields, compatibility names and runnable examples. - [Image to text](https://noptcha.com/docs/task-types/image-to-text.md): Solve Image to text with the Noptcha API: type image.text, parameters, solution fields, compatibility names and runnable examples. - [reCAPTCHA v2](https://noptcha.com/docs/task-types/recaptcha-v2.md): Solve reCAPTCHA v2 with the Noptcha API: type recaptcha.v2, parameters, solution fields, compatibility names and runnable examples. - [reCAPTCHA v2 Enterprise](https://noptcha.com/docs/task-types/recaptcha-v2-enterprise.md): Solve reCAPTCHA v2 Enterprise with the Noptcha API: type recaptcha.v2.enterprise, parameters, solution fields, compatibility names and runnable examples. - [reCAPTCHA v3](https://noptcha.com/docs/task-types/recaptcha-v3.md): Solve reCAPTCHA v3 with the Noptcha API: type recaptcha.v3, parameters, solution fields, compatibility names and runnable examples. - [reCAPTCHA v3 Enterprise](https://noptcha.com/docs/task-types/recaptcha-v3-enterprise.md): Solve reCAPTCHA v3 Enterprise with the Noptcha API: type recaptcha.v3.enterprise, parameters, solution fields, compatibility names and runnable examples. - [Cloudflare Turnstile](https://noptcha.com/docs/task-types/turnstile.md): Solve Cloudflare Turnstile with the Noptcha API: type turnstile, parameters, solution fields, compatibility names and runnable examples. ## Reference - [Errors](https://noptcha.com/docs/errors.md): Error codes of the Noptcha API: v1 problem details, task failure codes and compatibility API error codes. - [Rate limits and quotas](https://noptcha.com/docs/limits.md): Noptcha API rate limits, concurrency, request and image size, waiting and retention limits, and how to handle 429 responses. - [Versioning and compatibility](https://noptcha.com/docs/versioning.md): How the Noptcha API changes - backward-compatible additions in v1, at least 12 months for v1 after a v2, and what clients must tolerate. - [API reference](https://noptcha.com/docs/api-reference.md): Every operation of the Noptcha API, generated from the OpenAPI 3.1 description. ## Error codes - [invalid_request](https://noptcha.com/docs/errors/invalid_request.md): Noptcha API error invalid_request (HTTP 400): what it means and what to do. - [unsupported_type](https://noptcha.com/docs/errors/unsupported_type.md): Noptcha API error unsupported_type (HTTP 400): what it means and what to do. - [unauthorized](https://noptcha.com/docs/errors/unauthorized.md): Noptcha API error unauthorized (HTTP 401): what it means and what to do. - [insufficient_balance](https://noptcha.com/docs/errors/insufficient_balance.md): Noptcha API error insufficient_balance (HTTP 402): what it means and what to do. - [budget_exceeded](https://noptcha.com/docs/errors/budget_exceeded.md): Noptcha API error budget_exceeded (HTTP 402): what it means and what to do. - [forbidden](https://noptcha.com/docs/errors/forbidden.md): Noptcha API error forbidden (HTTP 403): what it means and what to do. - [not_found](https://noptcha.com/docs/errors/not_found.md): Noptcha API error not_found (HTTP 404): what it means and what to do. - [idempotency_conflict](https://noptcha.com/docs/errors/idempotency_conflict.md): Noptcha API error idempotency_conflict (HTTP 409): what it means and what to do. - [task_not_solved](https://noptcha.com/docs/errors/task_not_solved.md): Noptcha API error task_not_solved (HTTP 409): what it means and what to do. - [request_too_large](https://noptcha.com/docs/errors/request_too_large.md): Noptcha API error request_too_large (HTTP 413): what it means and what to do. - [invalid_params](https://noptcha.com/docs/errors/invalid_params.md): Noptcha API error invalid_params (HTTP 422): what it means and what to do. - [rate_limited](https://noptcha.com/docs/errors/rate_limited.md): Noptcha API error rate_limited (HTTP 429): what it means and what to do. - [concurrency_limited](https://noptcha.com/docs/errors/concurrency_limited.md): Noptcha API error concurrency_limited (HTTP 429): what it means and what to do. - [internal](https://noptcha.com/docs/errors/internal.md): Noptcha API error internal (HTTP 500): what it means and what to do. - [service_unavailable](https://noptcha.com/docs/errors/service_unavailable.md): Noptcha API error service_unavailable (HTTP 503): what it means and what to do. ## API reference: operations - [Create a task](https://noptcha.com/docs/api-reference/compat-create-task.md): POST /createTask: Create a task. Noptcha API reference. - [Get the balance](https://noptcha.com/docs/api-reference/compat-get-balance.md): POST /getBalance: Get the balance. Noptcha API reference. - [Get a task's result](https://noptcha.com/docs/api-reference/compat-get-task-result.md): POST /getTaskResult: Get a task's result. Noptcha API reference. - [Report a correct token](https://noptcha.com/docs/api-reference/compat-report-correct-recaptcha.md): POST /reportCorrectRecaptcha: Report a correct token. Noptcha API reference. - [Report a wrong image answer](https://noptcha.com/docs/api-reference/compat-report-incorrect-image-captcha.md): POST /reportIncorrectImageCaptcha: Report a wrong image answer. Noptcha API reference. - [Report a wrong token](https://noptcha.com/docs/api-reference/compat-report-incorrect-recaptcha.md): POST /reportIncorrectRecaptcha: Report a wrong token. Noptcha API reference. - [Create a task](https://noptcha.com/docs/api-reference/create-task.md): POST /v1/tasks: Create a task. Noptcha API reference. - [Get a task](https://noptcha.com/docs/api-reference/get-task.md): GET /v1/tasks/{id}: Get a task. Noptcha API reference. - [Report whether an answer worked](https://noptcha.com/docs/api-reference/send-task-feedback.md): POST /v1/tasks/{id}/feedback: Report whether an answer worked. Noptcha API reference. - [Get the balance](https://noptcha.com/docs/api-reference/get-balance.md): GET /v1/balance: Get the balance. Noptcha API reference. - [Get the public catalog and list prices](https://noptcha.com/docs/api-reference/get-catalog.md): GET /v1/catalog: Get the public catalog and list prices. Noptcha API reference. - [Describe the current key](https://noptcha.com/docs/api-reference/get-me.md): GET /v1/me: Describe the current key. Noptcha API reference. - [List task types and prices](https://noptcha.com/docs/api-reference/list-types.md): GET /v1/types: List task types and prices. Noptcha API reference. - [Get usage](https://noptcha.com/docs/api-reference/get-usage.md): GET /v1/usage: Get usage. Noptcha API reference. - [Schemas](https://noptcha.com/docs/api-reference/schemas.md): All schemas of the Noptcha API (OpenAPI components). ## More - [Noptcha](https://noptcha.com/index.md): A captcha solving API with an anti-captcha compatible protocol and a native REST API. Free sandbox keys for integration. - [Pricing](https://noptcha.com/pricing.md): How Noptcha charges for captcha tasks. Prices per task type are published before launch. ## Legal (drafts, not yet in effect) - [Terms of Service](https://noptcha.com/legal/terms.md): Draft terms for using Noptcha. Not yet in effect and not yet reviewed by counsel. - [Acceptable Use Policy](https://noptcha.com/legal/acceptable-use.md): Draft policy on what Noptcha may not be used for and how violations are handled. Not yet in effect. - [Privacy Policy](https://noptcha.com/legal/privacy.md): Draft policy on what personal data Noptcha collects, why, how long it is kept and your rights. Not yet in effect. - [Refund Policy](https://noptcha.com/legal/refunds.md): Draft policy on refunds of unused balance, promotional credit, payment disputes and chargebacks. Not yet in effect.