Skip to main content

​
POST /createTask

Creates a new FunCaptcha solving task and returns a task ID for polling.

​
Request Body

{
  "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@ip:port",
    "data": "{\"blob\": \"value\"}",
    "enablePOW": true,
    "headers": {
      "user-agent": "Mozilla/5.0 ...",
      "sec-ch-ua": "\"Chromium\";v=\"124\"",
      "sec-ch-ua-platform": "\"Windows\"",
      "sec-ch-ua-mobile": "?0",
      "accept-language": "en-US,en;q=0.9",
      "document-referrer": "https://example.com/",
      "document-title": "Page Title"
    }
  }
}

​
Parameters

​
Root

FieldTypeRequiredDescription
clientKeystringYesYour API key (FUN- or PKG- prefix)
taskobjectYesTask configuration object

​
Task Object

FieldTypeRequiredDescription
typestringYesMust be FunCaptchaTask
websiteURLstringYesURL of the target website
websitePublicKeystringYesArkose public key (UUID format)
websiteSubdomainstringYesArkose subdomain (e.g., client-api)
proxystringYesProxy in format protocol://user:pass@ip:port
datastringNoExtra data as JSON string (e.g., blob data)
enablePOWbooleanNoEnable Proof-of-Work solving (default: true)
headersobjectNoCustom browser headers

​
Headers Object

FieldTypeRequiredDescription
user-agentstringRequired if sec-ch-* headers are setBrowser User-Agent string
sec-ch-uastringNoClient Hints UA string
sec-ch-ua-platformstringNoClient Hints platform
sec-ch-ua-mobilestringNoClient Hints mobile flag
accept-languagestringNoAccept-Language header
document-referrerstringNoDocument referrer URL
document-titlestringNoDocument title

​
Response

​
Success (200)

{
  "errorId": 0,
  "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "created"
}

​
Service Unavailable (503)

{
  "errorId": 1,
  "errorCode": "ERROR_SERVICE_UNAVALIABLE",
  "errorDescription": "Service is temporarily unavailable."
}

​
Common Errors

Error CodeHTTPDescription
ERROR_MISSING_REQUEST_DATA400Request body is missing
ERROR_KEY_DOES_NOT_EXIST404Invalid API key
ERROR_TASK_NOT_SUPPORTED400Task type is not FunCaptchaTask
ERROR_INVALID_PUBLIC_KEY400Public key is not a valid UUID
ERROR_MISSING_PROXY400Proxy is required
ERROR_INVALID_PROXY_FORMAT400Proxy format is invalid
ERROR_TEMPLATE_NOT_FOUND404No template for this public key
ERROR_ZERO_BALANCE402Insufficient balance
ERROR_THREAD_THRESHOLD_EXCEEDED429Too many concurrent tasks

​
Example

import requests

resp = requests.post("https://api.funbypass.com/createTask", json={
    "clientKey": "FUN-your-api-key",
    "task": {
        "type": "FunCaptchaTask",
        "websiteURL": "https://example.com",
        "websitePublicKey": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "websiteSubdomain": "client-api",
        "proxy": "http://user:[email protected]:8080"
    }
})

print(resp.json())