API - Troubleshooting Surfe API Requests – SURFE

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 Authorization header as Bearer YOUR_API_KEY
Is 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.

Additional Resources