Find and Fix API Errors

Find common HTTP codes and troubleshooting hints to fix issues faster.

Status

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
5,000+
sales teams
4.8/5
G2 & Capterra
200M+
leads exported
65%
avg email find rate

Start exporting leads today

Free plan available. No credit card required. Export leads with verified emails and phones.