The Modern Treasury API uses standard HTTP response codes. Any 2xx response is successful. A 4xx means that there was an error with the data provided (like an invalid routing number). These errors can sometimes be handled programmatically by your application when we provide an error reason. A 5xx error means we encountered an error in our software, which we will work to fix immediately.
A table of status codes and their meanings can be found below.
2xx Success
Status Code
Description
200 OK
The request succeeded.
201 Created
The request succeeded and the new resource was created.
202 Accepted
The request has been accepted for processing, but the processing has not been completed.
4xx Client Errors
Status Code
Description
401 Unauthorized
The API key was invalid.
403 Forbidden
The account does not have access to the requested resource, or the request is blocked for security reasons.
404 Not Found
The resource that was requested could not be found.
409 Conflict
The request conflicts with another request.
413 Payload Too Large
The request exceeds the maximum supported size (25 MB)
422 Unprocessable Entity
Data was invalid or missing required parameters.
429 Too Many Requests
The account has issued too many requests.
5xx Server Errors
Status Code
Description
500 Internal Server Error
Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
502 Bad Gateway
Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
503 Service Unavailable
Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
504 Gateway Timeout
Our server encountered an error while processing your request. We will be notified and work on a fix immediately.
