HTTP Status Codes

HTTP Status Code Table

Status CodeStatusDescription
200OKThe API Request was successfully processed.
201CreatedTransaction Created, but Transaction Processing is Pending (batch).
207Multi-StatusOne or more upstream processing failed. Examples:
1. If you get a 207 during a Create Transaction request, this means the status of the transaction is unknown.
2. Retrieve OFAC Codes would return a 207 if the request was unable to reach WatchDog.
If you receive a 207 while using any resource, please contact your Evolve Account Manager.
400Bad RequestThe ResourceID is invalid
or
The Request Data is invalid. Example: one or more body parameters of your Create Transaction request are incorrect (e.g. too long, wrong format, json is not properly packed, etc.).
401UnauthorizedThe Authorization Token is invalid Make sure you are using the correct bearer token, please contact your Evolve Account Manager for assistance.
or
The IP Address is invalid (not whitelisted). Make sure your server’s IP addresses have been whitelisted. For more information contact your Evolve Account Manager.
403ForbiddenInvalid permissions to access the Resource. This resource has not been enabled for your account. Please contact your Evolve Account Manager.
404Not FoundThe ResourceID does not point to a valid Resource. Example: RetrieveClient would return a 404 if we do not have a Client that matches the ClientId you used. You will want to make sure you are using the correct ClientId.
405Method Not AllowedRequest Method Not Allowed for the Requested Resource. Example: Card API does not accept GET Requests. Please make sure you are using the right method for this resource.
406Not AcceptableOur Web Application Firewall (WAF) found something invalid in your request. Example: invalid characters or json formatting.
409ConflictReferenceID already used Example: If you are using RejectDuplicateCard when Creating Accounts you would receive a 409 if we detect a duplicate.
or
Conflicting Request Parameters.
410GoneThe Resource pointed to by the ResourceID has been marked for deletion. Example: DeleteKey would return a 410 if the Key you are trying to delete is already marked for deletion. You do not need to continue attempting to delete this Key.
415Unsupported Media TypeContent-type must be application/json.
421misdirected RequestToo late to Retrieve by ReferenceID, use AccountID or TransactionID. Please use the AccountID or TransactionID with your request.
422Unprocessed EntityThe Resource pointed to by the ResourceID is in an invalid state
or
Create Transaction: The Transaction Amount exceeded one or more Limits. This could also mean that the card you are trying to use is not enabled for the type of transaction (push or pull). You can use our CardQuery API to check what types of transaction that card is enabled for.
423LockedThe Resource pointed to by the ResourceID is locked. Example: RetrieveClient would return a 423 if the Client that matches the ClientId you used is locked. Please contact your Evolve Account Manager for more information as to why your Client account might be locked.
429Too Many RequestsRetrieve: Too many requests, please do not poll. Example: If you get a 429 response code that means that you are sending too many requests. Reduce the rate at which you send requests.
Create Transaction: Over your Daily (24-hour rolling) Approximation Limit.
431Request Header Fields too LargeToo many HTTP Header Lines and/or HTTP Header Lines too big. Please correct your HTTP Header Lines.
500Server ErrorThere was a problem processing the Request. Please contact your Evolve Account Manager for any 5XX errors you experience.
502Bad GatewayProblem connecting to an Application Server. Please contact your Evolve Account Manager for any 5XX errors you experience.
503Service UnavailableYour request cannot be processed, should be only a Temporary Condition. Please contact your Evolve Account Manager for any 5XX errors you experience.
504Gateway TimeoutConnection to an Application Server timed out. Please contact your Evolve Account Manager for any 5XX errors you experience.