Errors
The GodFocus Platform API uses standard HTTP status codes. All error responses have the same JSON shape:
{
"error": "Human-readable error message"
}
Error codes
401 โ Missing API key
{"error": "Missing or malformed API key"}
You did not include an Authorization header, or the format was wrong. Make sure you are sending Authorization: Bearer gfp_live_....
401 โ Invalid API key
{"error": "Invalid API key"}
The key you sent does not exist or has been revoked. Go to your Dashboard to check your active keys.
402 โ Insufficient credits
{"error": "Insufficient credits"}
Your account balance is 0. Purchase more credits to continue making API calls.
429 โ Rate limited
{"error": "Rate limited"}
You have exceeded 60 requests per minute per API key. Wait one minute and retry. If you need a higher limit, contact support.
500 โ Internal server error
{"error": "Internal server error"}
Something went wrong on our side. These are rare. If they persist, check the status page or email platform@godfocus.io.
Retry strategy
| Code | Retry? |
|---|---|
| 401 | No โ fix your API key |
| 402 | No โ add credits first |
| 429 | Yes โ after 60 seconds |
| 500 | Yes โ exponential backoff |