API Reference

Every endpoint, end to end.

A flat lookup for all endpoints, with every parameter, response field and error code. For a walkthrough with context, read the documentation instead.

Base URLhttps://cap.flowboosts.lol
AuthBearer <API_KEY>
openapi.json
GET/health

Liveness & Cluster Status

No authentication required. Returns cluster operational status and uptime. Use for heartbeat monitoring.

Request
curl -X GET "https://cap.flowboosts.lol/health"

200 OK
{
  "status": "operational",
  "name": "Flowcap",
  "version": "1.0.0",
  "uptime": "99.9%",
  "workers_online": 2
}

Response fieldsTypeDescription
statusstringOperational status (e.g. 'operational')
namestringService identifier (Flowcap)
versionstringCluster version
uptimestringCurrent uptime SLA (99.9%)
POST/v1/solve

Solve an hCaptcha Challenge

Submit the target sitekey, host, optional rqdata, and optional proxy. Returns an authentic P1_ enterprise token ready to submit. Single synchronous request.

Request
curl -X POST "https://cap.flowboosts.lol/v1/solve" \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sitekey": "4c672d35-0701-42b2-88c3-78380b0db0fe",
    "host": "discord.com",
    "rqdata": "optional_enterprise_rqdata",
    "proxy": "http://user:pass@ip:port"
  }'

200 OK
{
  "success": true,
  "status": "solved",
  "token": "P1_eyJ0eXAiOiJKV1QiLCJhbGci...",
  "time_taken": 11.4
}

ParametersTypeDescription
sitekey*stringThe hCaptcha sitekey rendered by the target page (e.g. Discord's 4c672d35-0701-42b2-88c3-78380b0db0fe).
hoststringTarget domain (e.g. 'discord.com'). Defaults to discord.com.
rqdatastringEncrypted enterprise rqdata provided by the target service.
proxystringOptional proxy URL (e.g. http://user:pass@ip:port or socks5://user:pass@ip:port). Every challenge is solved originating from your proxy IP.
Response fieldsTypeDescription
successbooleanTrue on successful solve
statusstringSolve status ('solved')
tokenstringVerified P1_ hCaptcha response token
time_takennumberTotal elapsed time in seconds
StatusCodeMeaning
400
sitekey_requiredMissing or malformed sitekey parameter
400
invalid_bodyRequest body is not valid JSON
401
unauthorizedMissing or invalid bearer API key
429
rate_limitAccount concurrency limit reached
500
solve_errorInternal worker resolution error
POST/v1/discord/solve

Discord CAPTCHA Interceptor

Directly pass Discord's 400 Bad Request CAPTCHA JSON body (containing captcha_sitekey, captcha_rqdata, and captcha_rqtoken). Returns ready-to-inject captcha_key payload.

Request
curl -X POST "https://cap.flowboosts.lol/v1/discord/solve" \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "captcha_sitekey": "4c672d35-0701-42b2-88c3-78380b0db0fe",
    "captcha_rqdata": "encrypted_rqdata_from_discord_400",
    "captcha_rqtoken": "session_rqtoken_from_discord_400",
    "proxy": "http://user:pass@ip:port"
  }'

200 OK
{
  "success": true,
  "captcha_key": "P1_eyJhbGciOi...",
  "captcha_rqtoken": "session_rqtoken_from_discord_400"
}

ParametersTypeDescription
captcha_sitekey*stringThe sitekey passed by Discord in the 400 response body.
captcha_rqdatastringThe encrypted rqdata passed by Discord.
captcha_rqtokenstringThe session rqtoken passed by Discord.
proxystringOptional proxy URL matching your Discord bot session.
Response fieldsTypeDescription
successbooleanTrue on successful solve
captcha_keystringThe verified response token to attach to your resubmitted Discord request
captcha_rqtokenstringThe returned session rqtoken for resubmission
StatusCodeMeaning
400
captcha_sitekey_requiredMissing captcha_sitekey
500
solve_errorChallenge solve failed
GET/v1/usage

Key Quota & Concurrency

Returns current key status, active plan tier, and allowed parallel concurrency slots.

Request
curl -X GET "https://cap.flowboosts.lol/v1/usage" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

200 OK
{
  "ok": true,
  "active": true,
  "plan": "Enterprise",
  "concurrency_limit": 20,
  "status": "operational"
}

Response fieldsTypeDescription
okbooleanTrue on success
activebooleanWhether the API key is active
planstringCurrent plan tier (e.g. 'Enterprise')
concurrency_limitintegerMax concurrent solve tasks
StatusCodeMeaning
401
unauthorizedMissing or invalid API key