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.
GET
/healthLiveness & 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 fields | Type | Description |
|---|---|---|
| status | string | Operational status (e.g. 'operational') |
| name | string | Service identifier (Flowcap) |
| version | string | Cluster version |
| uptime | string | Current uptime SLA (99.9%) |
POST
/v1/solveSolve 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
}| Parameters | Type | Description |
|---|---|---|
| sitekey* | string | The hCaptcha sitekey rendered by the target page (e.g. Discord's 4c672d35-0701-42b2-88c3-78380b0db0fe). |
| host | string | Target domain (e.g. 'discord.com'). Defaults to discord.com. |
| rqdata | string | Encrypted enterprise rqdata provided by the target service. |
| proxy | string | Optional 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 fields | Type | Description |
|---|---|---|
| success | boolean | True on successful solve |
| status | string | Solve status ('solved') |
| token | string | Verified P1_ hCaptcha response token |
| time_taken | number | Total elapsed time in seconds |
| Status | Code | Meaning |
|---|---|---|
400 | sitekey_required | Missing or malformed sitekey parameter |
400 | invalid_body | Request body is not valid JSON |
401 | unauthorized | Missing or invalid bearer API key |
429 | rate_limit | Account concurrency limit reached |
500 | solve_error | Internal worker resolution error |
POST
/v1/discord/solveDiscord 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"
}| Parameters | Type | Description |
|---|---|---|
| captcha_sitekey* | string | The sitekey passed by Discord in the 400 response body. |
| captcha_rqdata | string | The encrypted rqdata passed by Discord. |
| captcha_rqtoken | string | The session rqtoken passed by Discord. |
| proxy | string | Optional proxy URL matching your Discord bot session. |
| Response fields | Type | Description |
|---|---|---|
| success | boolean | True on successful solve |
| captcha_key | string | The verified response token to attach to your resubmitted Discord request |
| captcha_rqtoken | string | The returned session rqtoken for resubmission |
| Status | Code | Meaning |
|---|---|---|
400 | captcha_sitekey_required | Missing captcha_sitekey |
500 | solve_error | Challenge solve failed |
GET
/v1/usageKey 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 fields | Type | Description |
|---|---|---|
| ok | boolean | True on success |
| active | boolean | Whether the API key is active |
| plan | string | Current plan tier (e.g. 'Enterprise') |
| concurrency_limit | integer | Max concurrent solve tasks |
| Status | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key |