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
API Docs →
Enrich people by email (start)
Endpoint: POST /v2/people/find-by-email
API Docs →
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
What it means: You don't have enough credits to complete this request.
Next steps: Check your credit balance via your Surfe dashboard or the Get Credits endpoint and purchase more credits at surfe.com/buy-credits.
403 – Forbidden
What it means: The request cannot be handled because it would either exceed your daily quota or there are not enough credits available.
Next steps: Check your credit balance via your Surfe dashboard or the Get Credits endpoint. If you've hit your daily quota, wait until midnight for it to reset. If you need higher limits or are unsure what's causing this, contact our support team via Intercom and we'll help you out.
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.
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.
Comments
0 comments
Please sign in to leave a comment.