Errors

Iopole employs standard HTTP response codes to denote whether an API request has succeeded or failed.

Typically, codes in the 2xx range signify success, while codes in the 4xx range point to an error caused by the provided information (such as a missing parameter).


Codes in the 5xx range indicate server errors on Iopole end.
Certain 4xx errors, come with an error code that offers a brief explanation of the issue.

Status Code	Status	Description
20x	OK	Everything worked as expected.
400	Bad Request	The request was unacceptable, often due to missing a required parameter.
401	Unauthorized	No valid access token provided.
403	Forbidden	The access token doesn’t have permissions to perform the request.
404	Not Found	The requested resource doesn’t exist.
409	Conflict	The request conflicts with another request.
429	Too Many Requests	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500, 502, 503, 504	Server Errors	Something went wrong on Iopole’s end.