Finfare Connect API introducti...

Status and response codes

1min

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.