When using the Surfe People Search API, you may see different response codes depending on how the request is handled. Here’s a quick guide to what each code means and what to do next.
Search People
Endpoint: GET v2/people/search
A successful request is accompanied by a 20X status code that confirms the operation was completed as expected.
200 – Successful
What it means: The request worked, and the people you're searching for have been found.
Next steps: You're good to go! Use the results as needed.
In case of errors, the API responds with 4XX or 5XX status codes:
400 – Invalid Request
What it means: Something is wrong with the way the request was sent.
Next steps: Double-check the request format. Make sure all required fields are filled out correctly. If you're unsure, refer to the API documentation.
401 – Unauthorized
What it means: Your API key is missing or incorrect.
Next steps: Make sure you’ve included your API key in the request. You can find or manage your key in your Surfe account dashboard.
403 – People Search Quota Exceeded
What it means: You’ve used up your monthly or daily search quota.
Next steps: Check your quota usage in your account. If you need more searches, consider upgrading your plan or contact support.
500 – Internal Server Error
What it means: Something went wrong on our end.
Next steps: Try the request again after a short break. If the problem continues, please 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.
All error responses include the a JSON body with the following format:
{ "code": 400, // The same as the HTTP Status code "message": "Invalid request", // A message with an explanation of what went wrong }
If you’re ever unsure about a response or need help, don’t hesitate to contact our support team via intercom, we’re here to help!