Skip to content

Getting started

Everything you need to send your first uncaptcha.io request.

uncaptcha.io exposes a small synchronous REST API. Send a challenge to one endpoint and the completed solution is returned in the same response—there is no task ID to poll.

One endpoint

Every challenge uses POST /v1/task/execute. The task_type selects the solver and determines the shape of task_data.

Synchronous results

A successful response contains data.solution. Requests have a hard 30-second execution timeout.

Charge on success

Pay-as-you-go balance and bundle quota are restored automatically when a solve fails or times out.

Any HTTP client

The API is plain JSON over HTTPS. No SDK is required.

Base URL

https://api.uncaptcha.io/v1

All examples in this documentation use the production API.

Start here

  1. Create an API key and make your first request.
  2. Read authentication before putting the key into production.
  3. Choose a supported task type.
  4. Handle the error and billing model.
Navigation

Type to search…

↑↓ navigate↵ selectEsc close