Create a job

Returns at once with 202 Accepted and the job in the queued state. The Location header holds the job path. Read the job with Get a job until it is done or failed.

POST /v1/jobs

Create a job

cURL

curl --request POST \
  --url https://api.bapsolver.xyz/v1/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kind": "recap_v3",
  "url": "https://example.com/login",
  "siteKey": "6Lc...",
  "action": "login"
}
'

202

{
  "ok": true,
  "requestId": "0f6c1d2e-8a4b-4c3d-9e1f-2a3b4c5d6e7f",
  "data": {
    "id": "3b1f7c9a-2d4e-4f6a-8b0c-1d2e3f4a5b6c",
    "kind": "recap_v3",
    "url": "https://www.example.com/login",
    "siteKey": "YOUR_SITE_KEY",
    "action": "login",
    "status": "queued",
    "createdAt": "2026-10-25T09:30:00.000Z"
  }
}

Authorizations

Authorization · string · header · required

Your API token. Send it on every /v1 request as Authorization: Bearer <API_TOKEN>.

Body

application/json

kind · enum<string> · required

recap_v3: reCAPTCHA v3. recap_v3_enterprise: reCAPTCHA Enterprise. The _proxy kinds run through the proxy sent with the job; the others take none.

Available options: recap_v3, recap_v3_enterprise, recap_v3_proxy, recap_v3_enterprise_proxy

url · string<uri> · required

The page the challenge is on; the token is for its origin.

Maximum string length: 4096

siteKey · string · required

Required string length: 1 - 256

action · string · default: submit

The reCAPTCHA v3 action.

Required string length: 1 - 100

Pattern: ^[A-Za-z0-9/_]+$

proxy · string

Proxy for the _proxy kinds: a pool id or IP:PORT:USER:PASS. Credentials are never echoed back.

Required string length: 3 - 512

Response

202

application/json

The job was queued.

ok · any · required

requestId · string<uuid> · required

Server-generated correlation identifier; caller-supplied identifiers are ignored.

data · object · required

Show child attributes