Troubleshooting & Errors


For all successful requests, the API returns an HTTP status of 200. If there is an error, the API returns an appropriate 4XX or 5XX HTTP status code. In addition, the API passes an error code and message. These messages can help determine the reason for the failure, particularly for poorly formed query parameters.

Example responses for a bad query:

JSON

GET /v1/rates/USD.json?quote=GBD
1
HTTP/1.1 400 Bad Request
1
2
3
4
{
   "code" : 1,
   "message" : "Invalid or malformed argument; [quote] must be a valid 3 letter currency code as defined by [currencies] endpoint: (GBD)"
}

XML

GET /v1/rates/USD.xml?quote=GBD
1
HTTP/1.1 400 Bad Request
1
2
3
4
<response>
  <code>1</code>
  <message>Invalid or malformed argument; [quote] must be a valid 3 letter currency code as defined by [currencies] endpoint: (GBD)</message>
</response>

CSV

GET /v1/rates/USD.csv?quote=GBD
1
HTTP/1.1 400 Bad Request
1
2
code,message
1,"Invalid or malformed argument; [quote] must be a valid 3 letter currency code as defined by [currencies] endpoint: (GBD)"

List of Errors

The message provided with any particular error may contain additional information to help you determine the cause of the problem, particularly in the case of malformed or invalid query parameters.

code HTTP Status Code HTTP Status Message Message Detailed description
1 400 Bad Request Invalid or malformed argument; (information) The argument specified is not properly formatted or is an unaccepted value
2 400 Bad Request Missing required argument  
3 401 Unauthorized This request requires authorization  
4 401 Unauthorized The access token provided does not allow this request to be made; (information) The provided API key does not have privilege for the request (no access to Central Bank rates is one instance)
5 500 Internal Server Error An internal server error occurred, our engineers have been notified  
6 503 Service Unavailable Service Unavailable The API is down for maintenance
8 400 Bad Request Malformed Authorization header or invalid access token  
10 404 Not Found Quotes not found No quotes matched your query
11 404 Not Found Invalid Endpoint When no matching endpoint could be found
53 503 Rate Limit Rate limit violation You have exceed your allocation of quotes for the current billing period
54 403 Forbidden Expected rates returned from this API call is more than the number of quotes remaining for this account  
55 400 Bad Request The combinations of currency pairs and dates may not exceed the limit allowed per request  
57 405 Method Not Allowed Invalid request Caused by an incompatible HTTP method such as POST, or an invalid header in request