Create a Task
curl -X POST https://api.funbypass.com/createTask \
-H "Content-Type: application/json" \
-d '{
"clientKey": "FUN-your-api-key",
"task": {
"type": "FunCaptchaTask",
"websiteURL": "https://example.com",
"websitePublicKey": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"websiteSubdomain": "client-api",
"proxy": "http://user:pass@1.2.3.4:8080"
}
}'
{
"errorId": 0,
"taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "created"
}
Get Task Result
ReplaceTASK_ID with the task ID from the previous response:
curl https://api.funbypass.com/getTaskResult/TASK_ID
{
"errorId": 0,
"taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "processing"
}
{
"errorId": 0,
"solution": {
"token": "282d9a2536f.d..."
},
"taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "ready"
}
Check Balance
curl -X POST https://api.funbypass.com/getBalance \
-H "Content-Type: application/json" \
-d '{"clientKey": "FUN-your-api-key"}'
{
"errorId": 0,
"balance": 12.50
}
With Custom Headers
Theheaders block is optional — leave it out and we handle the browser headers for you.
curl -X POST https://api.funbypass.com/createTask \
-H "Content-Type: application/json" \
-d '{
"clientKey": "FUN-your-api-key",
"task": {
"type": "FunCaptchaTask",
"websiteURL": "https://example.com",
"websitePublicKey": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"websiteSubdomain": "client-api",
"proxy": "http://user:pass@1.2.3.4:8080",
"enablePOW": true,
"headers": {
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
"sec-ch-ua": "\"Chromium\";v=\"124\", \"Google Chrome\";v=\"124\"",
"sec-ch-ua-platform": "\"Windows\"",
"sec-ch-ua-mobile": "?0",
"accept-language": "en-US,en;q=0.9"
}
}
}'
With Extra Data (Blob)
curl -X POST https://api.funbypass.com/createTask \
-H "Content-Type: application/json" \
-d '{
"clientKey": "FUN-your-api-key",
"task": {
"type": "FunCaptchaTask",
"websiteURL": "https://example.com",
"websitePublicKey": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"websiteSubdomain": "client-api",
"proxy": "http://user:pass@1.2.3.4:8080",
"data": "{\"blob\": \"your-blob-value-here\"}"
}
}'
Shell Script: Create + Poll
A complete bash script that creates a task and polls for the result:#!/bin/bash
API_KEY="FUN-your-api-key"
BASE_URL="https://api.funbypass.com"
# Create task
RESPONSE=$(curl -s -X POST "$BASE_URL/createTask" \
-H "Content-Type: application/json" \
-d "{
\"clientKey\": \"$API_KEY\",
\"task\": {
\"type\": \"FunCaptchaTask\",
\"websiteURL\": \"https://example.com\",
\"websitePublicKey\": \"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\",
\"websiteSubdomain\": \"client-api\",
\"proxy\": \"http://user:pass@1.2.3.4:8080\"
}
}")
TASK_ID=$(echo "$RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin)['taskId'])")
echo "Task created: $TASK_ID"
# Poll for result
for i in $(seq 1 600); do
RESULT=$(curl -s "$BASE_URL/getTaskResult/$TASK_ID")
STATUS=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['status'])")
if [ "$STATUS" = "ready" ]; then
TOKEN=$(echo "$RESULT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('solution',{}).get('token','ERROR'))")
echo "Result token: $TOKEN"
exit 0
fi
echo "Status: $STATUS (attempt $i)"
sleep 0.5
done
echo "Timeout: task did not finish"
exit 1