VoidSolver

API Documentation

Complete reference for integrating VoidSolver into your application

Getting Started

The VoidSolver API uses a simple two-step process: create a task and retrieve the result. All requests require authentication via your API key. The service uses an external captcha solver API (http://20.70.144.186:3000/) for reliable hCaptcha solving.

Base URL: https://voidsolver.tech/api

Authentication

All API requests require your unique API key. Include it in the Authorization header as a Bearer token.

Authorization: Bearer YOUR_API_KEY

You can get your API key from your dashboard after signing up.

Create Task
POST

Submit a captcha solving task to our AI service.

Endpoint

POST /createtask

Headers

AuthorizationBearer YOUR_API_KEYrequired
Content-Typeapplication/jsonrequired

Request Body

proxystringrequired
rqdatastringoptional
site_urlstringrequired
site_keystringrequired

Examples

curl -X POST https://voidsolver.vercel.app/api/createtask \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "proxy": "http://username:password@proxy.example.com:8080",
    "rqdata": "captcha_payload_here",
    "site_url": "discord.com",
    "site_key": "a9b5fb07-92ff-493f-86fe-352a2803b3df"
  }'

Response

{
  "taskId": "xxxx-xxxx-xxxx-xxxx"
}

Get Task Result
GET

Retrieve the result of a previously submitted task.

Endpoint

GET /gettaskresult?taskid=<taskId>

Headers

AuthorizationBearer YOUR_API_KEYrequired

Query Parameters

taskidstringrequired

Examples

curl -X GET "https://voidsolver.vercel.app/api/gettaskresult?taskid=xxxx-xxxx-xxxx-xxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

When task is still processing:

{
  "status": "pending"
}

When task is completed:

{
  "status": "success",
  "solvedToken": "P1_eyJ0eXAiOiJKV1QiLCJ...."
}

Get All Tasks
GET

Retrieve all tasks associated with your API key with pagination and optional filtering.

Endpoint

GET /getalltasks

Headers

AuthorizationBearer YOUR_API_KEYrequired

Query Parameters

limitnumber (default: 50)optional
offsetnumber (default: 0)optional
statuspending|success|failedoptional

Example

curl -X GET "https://voidsolver.vercel.app/api/getalltasks?limit=20&status=success" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "tasks": [
    {
      "taskId": "xxxx-xxxx-xxxx-xxxx",
      "site": "discord.com",
      "sitekey": "a9b5fb07-92ff-493f-86fe-352a2803b3df",
      "status": "success",
      "solvedToken": "P1_eyJ0eXAiOiJKV1QiLCJ....",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-01T00:05:00.000Z"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Solve Advance (Advanced solver)
GET / POST

Endpoint

GET /api/solve-advance?url=...&sitekey=...&rqdata=...&user_agent=YOUR_USER_AGENT_STRING

POST /api/solve-advance
Body:
{
  "url": "...",
  "sitekey": "...",
  "rqdata": "...",
  "user_agent": "YOUR_USER_AGENT_STRING"
}

Parameters

urlstringrequired
sitekeystringoptional
rqdatastringoptional
user_agentstringrequired
proxystringoptional

Examples

curl -G "https://voidsolver.vercel.app/api/solve-advance" \
  --data-urlencode "url=https://discord.com" \
  --data-urlencode "sitekey=your_sitekey_here" \
  --data-urlencode "rqdata=your_rqdata_here" \
  --data-urlencode "user_agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36" \
  --data-urlencode "proxy=http://username:password@proxy.example.com:8080"

Task Status Lookup

Check the status of a previously created solve task.

GET /api/solve-advance/task/:taskid

Response

{
  "taskid": "abcde",
  "status": "not_ready"
}

Error Handling

The API uses standard HTTP status codes to indicate success or failure.

200
Success
400
Bad Request - Invalid parameters
401
Unauthorized - Invalid API key
402
Payment Required - No solves remaining
500
Internal Server Error

Error Response Format

{
  "error": "Invalid API key",
  "code": 401
}
Captcha Solver Integration