When using the Enrich People API on Surfe, your request may return different response codes depending on the outcome. Here’s a simple guide to what they mean and what to do next.
Enrich People (start)
Endpoint: POST /v2/people/enrich
202 – Request Accepted
What it means: Your enrichment request was received and is being processed.
Next steps: Use the returned
enrichmentIDto check the status using the GET endpoint.
400 – Invalid Request
What it means: Some required information is missing or incorrectly formatted.
Next steps: Double-check your request data. Make sure you're following the format shown in the API documentation.
401 – Unauthorized
What it means: Your API key is missing or invalid.
Next steps: Confirm you’ve included a valid API key in the request headers.
402 – Not Enough Credits / Daily Quota exceeded
What it means: You’ve run out of credits or you’ve exceeded your daily quota.
Next steps: Check your available credits or contact support to upgrade your plan.
403 – Forbidden
What it means: Your account doesn’t have access to this feature.
Next steps: Make sure your current plan includes enrichment. Contact support if you're unsure.
500 – Internal Server Error
What it means: Something went wrong on our side.
Next steps: Wait a moment and try again. If the issue continues, reach out to the support team via intercom.
503 – Time out
What it means: Request timed out. Current operation took too long to complete and was aborted.
Next steps: Wait a few minutes and try again. If the issue continues, contact the support team via intercom.
Enrich People (get)
Endpoint: GET /v2/people/enrich/{id}
200 – Success
What it means: Your bulk enrichment results are ready.
Next steps: Review the returned data and use it as needed.
400 – Invalid Request
What it means: The request is not properly formatted.
Next steps: Ensure the
enrichmentIdis correct and follows the API format.
401 – Unauthorized
What it means: Your API key is missing or invalid.
Next steps: Verify that your API key is included and active.
403 – Forbidden
What it means: Your API key is valid, but you don’t have access to this endpoint.
Next steps: Check your plan or permissions. Contact support if needed.
404 – Not Found
What it means: No enrichment found with this ID.
Next steps: Confirm you are using the correct
enrichmentId. If you're sure it's correct, contact support.
500 – Internal Server Error
What it means: Something went wrong on our side.
Next steps: Try again shortly. If the problem persists, contact support.
If you’re ever unsure about an error or how to fix it, our team is here to help. Reach out to the support team via intercom.