Skip to main content
POST
Create an hCaptcha solve
Create an hCaptcha token solve. A successful solve is charged against your prepaid balance.

Authorizations

Authorization
string
header
required

Ninetile API key, sent as Authorization: Bearer <key>. Keys are issued in the dashboard.

Query Parameters

wait
integer

Wait this many seconds for a final result (1–90). If omitted, return without waiting.

Required range: 1 <= x <= 90

Body

application/json
type
enum<string>
required
Available options:
hcaptcha,
hcaptcha_enterprise
sitekey
string<uuid>
required

hCaptcha sitekey UUID.

url
string<uri>
required

HTTP or HTTPS URL of the page containing the challenge.

Maximum string length: 2048
Pattern: ^https?://
rqdata
string

Fresh hCaptcha rqdata, when the page provides one.

Maximum string length: 16384
user_agent
string

Accepted but not applied. The solve response provides the user agent to use when submitting the token.

Maximum string length: 512
proxy

Optional public HTTP or HTTPS proxy. SOCKS proxies are not supported.

Response

Solve reached a final state while waiting.

id
string
required
Pattern: ^solve_
object
any
required
type
enum<string>
required
Available options:
hcaptcha,
hcaptcha_enterprise
status
enum<string>
required
Available options:
pending,
solving,
solved,
failed,
cancelled,
expired
sitekey
string<uuid>
required
url
string<uri>
required
token
string | null
required

hCaptcha response token when the solve succeeds; otherwise null. Token is cleared after 7 days.

user_agent
string | null
required
error
object | null
required
charged_usd
number | null
required

Final charge; null until the solve is final.

proxy_bytes
null
required

Currently always null.

created_at
string<date-time>
required
started_at
string<date-time> | null
required
finished_at
string<date-time> | null
required
queue_ms
integer | null
required
resolve_ms
integer | null
required
warnings
object[]
required