The API uses HTTP response codes to indicate the success or failure of a request. Codes in the 2xx
range indicate success, codes in the 4xx
range indicate an error in your request, and codes in the 5xx
range indicates an error with Treasury Prime's servers or the backing bank systems. In particular, an HTTP 502 error most often indicates that the bank's core system is offline due to maintenance. Any asynchronous actions, such as book transfers, will be completed once the core system is back online. Please note that some API endpoints may return a 429
status code during times of high request volume, your application should be expected to implement some basic backoff and retry logic for this scenario. Some endpoints will return this status code as part of exceeding an account limit though, instances of this will be covered in those endpoints respectively.
In addition to the HTTP response code, most errors also include more detailed information about the problem in the response body. The detailed error message will be encoded in a JSON response under the error
key.
Example Response
{
"error": "Parameter 'amount' must be greater than '0'.
}