API Keys
FunBypass uses API keys for authentication. Your key is passed in the request body as the clientKey field — there are no headers or bearer tokens required.
Key Types
Prefix Type Description FUN-Balance-based Pay-per-solve at $0.75/1,000 solves. Balance is deducted per task. PKG-Package-based Subscription packages with daily/hourly quotas or unlimited solves.
Getting Your API Key
Sign up at app.funbypass.com
Navigate to Dashboard → Settings
Copy your API key
Keep your API key secret. Do not expose it in client-side code or public repositories.
Authentication Flow
Every API request requires your clientKey in the request body:
{
"clientKey" : "FUN-your-api-key-here" ,
"task" : { ... }
}
The server validates your key and checks:
Key existence — The key must be registered
Account status — Account must not be suspended
Package validity — For PKG- keys, the package must be active and not expired
Balance/Quota — Sufficient balance or remaining quota for the request
Balance-Based Keys (FUN-)
Cost: 0.75 p e r 1 , 000 s o l v e s ( 0.75 per 1,000 solves ( 0.75 p er 1 , 000 so l v es ( 0.00075 per solve)
Balance is deducted when a task starts processing
If the task fails, the balance is automatically refunded
Check your balance via the POST /getBalance endpoint
Package-Based Keys (PKG-)
Packages come in several types:
Type Description unlimitedNo solve limit during the subscription period dailyFixed number of solves per day, resets daily hourlyFixed number of solves per hour, resets hourly
Package status can be active, paused, or expired. Only active packages can create tasks.
Error Responses
If authentication fails, you’ll receive one of these errors:
Error Code Description ERROR_KEY_DOES_NOT_EXISTAPI key not found ERROR_ACCOUNT_SUSPENDEDAccount has been suspended ERROR_PACKAGE_PAUSEDPackage is currently paused ERROR_PACKAGE_EXPIREDPackage subscription has expired ERROR_ZERO_BALANCEInsufficient balance (balance-based keys) ERROR_RATE_LIMIT_EXCEEDEDDaily or hourly quota exceeded (package keys)
Next Steps
Create a Task Start solving CAPTCHAs with the createTask endpoint.
Check Balance Query your current balance programmatically.