Find and Fix API Errors
Find common HTTP codes and troubleshooting hints to fix issues faster.
The Scrupp API uses standard HTTP status codes to indicate success or failure. Codes in the 2xx range mean the request succeeded. Codes in the 4xx range indicate a client-side problem — such as missing parameters, invalid authentication, or exceeding your plan limits. Codes in the 5xx range signal a server-side issue that is usually temporary. When you receive an error, the response body includes a JSON object with an error field describing what went wrong. For rate-limit errors (429), always respect the Retry-After header and use exponential backoff to avoid being throttled further. Most integration issues can be resolved in minutes by checking your API key, verifying request parameters, and confirming your plan has sufficient credits.
| Code | Meaning | What to do |
|---|---|---|
| 400 | Bad request | Check JSON / params |
| 401 | Unauthorized | Check api_key |
| 403 | Forbidden | Check plan/permissions |
| 429 | Rate limit | Retry with backoff |
| 500 | Server error | Retry / contact support |