Cardcore uses standard HTTP response codes to show whether an API request succeeded or failed. In general:
  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate an error in the request, such as a missing parameter or invalid credential.
  • Codes in the 5xx range indicate an error on the Cardcore server side. These should be rare.

​
Response codes

CodeDescription
200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable, often because a required parameter was missing.
401 - UnauthorizedNo valid API key or access token was provided.
402 - Request FailedThe parameters were valid, but the request failed.
403 - ForbiddenThe credential used does not have permission to perform the request.
404 - Not FoundThe requested resource does not exist.
409 - ConflictThe request conflicts with another request.
429 - Too Many RequestsToo many requests were sent in a short period. Use exponential backoff before retrying.
500, 502, 503, 504 - Server ErrorsSomething went wrong on the Cardcore side. If this persists, contact support.

​
When to retry

Retry only when the failure is likely to be temporary, such as 429 or a 5xx response. For 4xx errors, review your request data, authentication, and permissions before sending the request again.