Status Codes

The MCB 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 will work to fix immediately.

A table of status codes and their meanings can be found below.

2xx Success

Status CodeDescription
200 OKThe request succeeded.
201 CreatedThe request succeeded and the new resource was created.

4xx Client Errors

Status CodeDescription
400 Bad RequestData was invalid or missing required parameters.
401 UnauthorizedThe API key was invalid.
403 ForbiddenThe account does not have access to the requested resource.
404 Not FoundThe resource that was requested could not be found.

5xx Server Errors

Status CodeDescription
500 Internal Server ErrorOur server encountered an error while processing your request. We will be notified and work on a fix immediately.
502 Bad GatewayOur server encountered an error while processing your request. We will be notified and work on a fix immediately.
503 Service UnavailableOur server encountered an error while processing your request. We will be notified and work on a fix immediately.
504 Gateway TimeoutOur server encountered an error while processing your request. We will be notified and work on a fix immediately.

Errors

A list of common error codes within the MCB API can be found below

Error CodeDescription