Status and response codes
The uses conventional HTTP response codes to indicate the success or failure of an API request.
The general convention for the error codes are as follows:
- Codes in the 200s indicate success.
- Codes in the 400s indicate an error that failed, and provides additional information for the failure.
- Codes in the 500s indicate an error with Finfare's servers. These are rare occurrences.
Code | Text | Description |
---|---|---|
200 | OK | The request was successful. |
202 | Accepted | The request was accepted for processing, but processing is not yet completed. |
400 | Bad Request | The request was not accepted due to a malformed client request. |
401 | Unauthorized | An invalid API key was used. |
403 | Forbidden | The API key doesn’t have permissions to perform the request. |
404 | Not Found | The requested resource doesn’t exist. |
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 Finfare's end. These errors are rare occurrences. |