The following codes are used in the status
field to provide information about the logical result of a specific API call. Status codes provide additional information with respect to HTTP response codes: for example, an HTTP/1.1 200 (OK) response code may still contain a KO status code to indicate that the call was successful on the protocol layer, but it actually failed from the business logic perspective.
OK
The operation was successful. Thepayload
response element may provide additional response data.KO
The operation failed. Theerror
orerrors
response element may provide additional information about the occurred error.PENDING
The operation requires additional information to be executed (for example, the response to an authorization challenge).
The following table provides a quick reference to the supported status codes in each API version.
API Version | OK Status |
KO Status |
PENDING Status |
1.0 | YES | YES | NO |
2.0 | YES | YES | YES |
2.1 | YES | YES | YES |
3.0 | YES | YES | YES |
4.0 | YES | YES | YES |