Developers

API reference

Three endpoints: submit a task, poll its status, check your balance.

Base URL and authentication

Base URL https://claudekycbypass.com

Authentication

Two methods are accepted; pick either one.

Method	How
Bearer header	Send `Authorization: Bearer <token_key>`. Recommended.
Parameter	Send `key` in the JSON body (POST) or as a query parameter (GET).

POST

Submit a verification task

Submits a Persona inquiry URL for processing. A successful submission deducts one credit and returns a task_id.

Endpoint /api/kyc/submit

Body parameters (JSON)

Name	Type	Required	Description
key	string	Optional	Your token key. Omit when using Bearer authentication.
kyc_link	string	Required	The full Persona inquiry verification URL.
country	string	Optional	Target region code — `US`, `GB`, `CA`, `AU`, `DE`, `FR`, `JP`, `SG`, `TW`, `KR`, `BR`, `IN`. Defaults to `RANDOM`.

Request

curl -X POST "https://claudekycbypass.com/api/kyc/submit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer kyc_test_token_8888" \
  -d '{
    "kyc_link": "https://inquiry.withpersona.com/verify?inquiry-id=inq_xxxxxxxx",
    "country": "US"
  }'

Response — 200 OK

{
  "success": true,
  "task_id": "task_73921a8f90c42",
  "message": "Task submitted to verification queue."
}

GET

Query task status

Poll the current state of a task by its task_id.

Endpoint /api/kyc/status?task_id={task_id}&key={your_key} With Bearer authentication, drop key: /api/kyc/status?task_id={task_id}

Request

curl "https://claudekycbypass.com/api/kyc/status?task_id=task_73921a8f90c42" \
  -H "Authorization: Bearer kyc_test_token_8888"

Response — 200 OK

{
  "success": true,
  "task_id": "task_73921a8f90c42",
  "status_code": 2,
  "status_text": "success",
  "message": "Identity verification completed."
}

Status codes

Code	Meaning
0	Queued — awaiting a worker
1	Processing
2	Passed
3	Failed or expired — no credit charged

GET

Query credit balance

Returns the number of verifications remaining on a token key.

Endpoint /api/kyc/balance?key={your_token_key} With Bearer authentication: /api/kyc/balance

Request

curl "https://claudekycbypass.com/api/kyc/balance" \
  -H "Authorization: Bearer kyc_test_token_8888"

Response — 200 OK

{
  "success": true,
  "key": "kyc_test_token_8888",
  "balance": 9
}

Need credits to test with?

Buy a pack and get a token key immediately after the transfer confirms.

Buy credits