Potential errors

The most common error messages you could find when sending a request to our API with explanations and possible workarounds.

HTTP Status Codes

Code

Name

Reason

200

OK

Standard response for successful API request

400

Bad Request

The server cannot process the request due to a malformed request syntax

403

Forbidden

The user token may not have the necessary permissions to make API request

404

Not Found

The API endpoint you are trying to reach does not or exist or is misspelled

500

Internal Server Error

A generic error message due a internal communication error

Error Messages

Sample error responses

Invalid Token

{
  "message":"The token provided is invalid"
}

Search limit reached

{
  "message":"Company search limit reached. Searches done: 1000 / 1000"
}

Search request failed

{
  "message":"Search request failed"
}

Message

Reason

Workaround

API too busy, please try again

The predictor is processing too many requests at the same time

Try again later, if the problem persists, contact with support at [email protected]

The field [name] is required

The company name is missing in the request

Provide the company name under the “name” field

The field [token] is required

The user token is missing in the request

You have to provide your unique API Token in the request

The token provided is invalid

The token you provided is invalid

Make sure your API Token is correct. If the problem persists, contact with support

Company search limit reached

You have reached the limit of requests you are allowed to make

Contact support at [email protected]

Search request failed

An unexpected error happened when trying to process your request

Try again later, if the problem persists, contact with support at [email protected]


Did this page help you?