Start Here
Before diving into specific issues, check these three things first:
Is your API key included? Every request needs a valid API key in the
Authorizationheader asBearer YOUR_API_KEYIs your request body correctly formatted? All requests must be valid JSON with the correct fields.
Have you checked the error code? The response will always include a code and message telling you what went wrong.
Common Issues & Where to Go
Getting a 401? Your API key is missing or invalid. Check your Authorization header and make sure your key is active in your API Settings. → See: Find your Surfe API Key
Getting a 400? Your request is malformed or missing required fields. Check the error message in the response body — it will tell you exactly what's wrong. → See the response codes article for the endpoint you're using
Getting a 402? You've run out of credits. Check your balance and purchase more if needed. → See: API - Credits & Quotas
Getting a 403? You've hit your daily quota or don't have enough credits. Wait until midnight for your quota to reset or contact support. → See: API - Credits & Quotas
Getting a 429? You're sending requests too fast. Slow down and try again — the rate limit resets every minute. → See: API - Rate Limits
Getting a 404? The enrichmentID you're using doesn't exist or is incorrect. Double check it was copied correctly from the start enrichment response. → See the relevant enrichment article for the endpoint you're using
Getting a 500 or 503? Something went wrong on Surfe's side. Wait a moment and try again. If it persists, contact support via Intercom.
Enrichment returning no data? → See: API - Why Am I Getting No Data
Webhook not arriving? → See: API - Webhook Troubleshooting
Not sure which endpoint to use? → See: API - Getting Started with the Surfe API
Still Stuck?
If none of the above resolves your issue, reach out to our support team via Intercom and we'll help you get to the bottom of it.