Trustpair uses conventional HTTP response codes to indicate the success or failure of an API request.

In general:

Codes in the 2xx range indicates success.
Codes in the 4xx range indicates an error due to the information that were provided (e.g., a required parameter was omitted, a charge failed, etc.)
Codes in the 5xx range indicates an error with Trustpair's servers (these are rare).

HTTP Status Code	Description
200 - OK	Everything worked as expected
202 - Accepted	The request has been accepted and processing has not been completed yet
401 - Unauthorized	No valid API key or no API key was provided.
403 - Forbidden	The API key does not have the necessary permissions to perform the request
404 - Not Found	The requested resource could be not found.
422 - Un-processable entity	The request format was invalid. See more below.
429 - Too many requests	Too many requests were received. We recommend spacing requests increasing the interval between your requests, for instance using an exponential backoff.
500 - Internal Server Error	The Trustpair API experienced an internal server error. Our team has been notified and is working to fix it.

📘
More infos about 422 errors
For all POST requests, when there are format errors or missing mandatory or conditional data, Trustpair's API will answer with a 422 HTTP answer code. The answer will contain more information about the more specific reason why the format was invalid. Here is the list of potential answers:

Type	Key	Reason for failure	EN message
Bank	iban	Missing	"At least one of the bank account identifiers must be present"
Bank	bank_account_number	Missing	"At least one of the bank account identifiers must be present"
Bank	bank_account_type	Incorrect	"Invalid account number"_OR "This country uses the IBAN format, please select IBAN as the account type"_
Bank	bank_account_bic	Missing	"Required if bank_account_number is present"
Bank	bic	Incorrect	"Invalid BIC number"
Company	company_country_code	Missing/Incorrect	"Required"
Company	company_registration	Missing	"At least one of the company identifiers must be present"
Company	tax_number	Missing	"At least one of the company identifiers must be present"
Company	duns	Missing	"At least one of the company identifiers must be present"
Company	company_registration_type	Incorrect	"Invalid company registration"

Note that the answer will contain the list of errors if there are more than one (see example below)

{
  "errors": {
    "company_country_code": [
      "Required"
    ],
    "bank_account_bic": [
      "Required if bank_account_number is present"
    ]
  }
}