Search Companies - Response Codes & Troubleshooting
When using the Search Companies/Lookalikes endpoint 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.
Search Companies Lookalikes
Endpoint: POST v1/organizations/lookalikes
Search Companies
Endpoint: POST v2/companies/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.
401 - Unauthorised
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 – You Don’t Have Access
What it means: You’ve used up your monthly or daily Company lookalikes 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.