API - Get Company Leadership Changes - Response Codes & Troubleshooting

When using the Get Company Leadership Changes 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.

Endpoint: POST /v2/companies/signals/leadership-change

API Docs →

Successful Responses

A successful request is accompanied by a 20X status code that confirms the operation was completed as expected.

200 – Success

• What it means: Your request worked and the leadership changes have been returned.
• Next steps: You're good to go! Use the results as needed. If there are more results available use the nextPageToken to fetch the next page.

Error Responses

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: Check that companyDomain is included in your request and that leadershipChange contains at least one of types or changedSince. Refer to the API documentation for the correct format.

401 – Unauthorized

• What it means: Your API key is missing or invalid.
• 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.

402 – Not Enough Credits

• What it means: Your account does not have enough search credits to complete this request. Search credits must be enabled on your account to use this endpoint. Next steps: Check your search credit balance via the Get Credits endpoint (GET /v1/credits). To purchase more credits or enable search credits on your account, contact api.support@surfe.com.

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 Zendesk and we'll help you out.

404 – Not Found

• What it means: The company domain you provided was not found.
• Next steps: Check that the company domain is correct and try again.

429 – Too Many Requests

• What it means: You've exceeded the rate limit by sending too many requests too quickly.
• Next steps: Slow down your requests and try again. The rate limit resets every minute. You can send up to 10 requests per second, with bursts of up to 20 occasionally.

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 Zendesk or email api.support@surfe.com.

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 Zendesk.