Skip to main content
Yuko uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error caused by the information provided. Codes in the 5xx range indicate an error on Yuko’s servers.

Error response codes

Status CodeDescription
400The request was not accepted, often due to missing parameters, bad syntax, or a missing Content-Type header.
401The required authentication credentials are missing or incorrect.
403The server is refusing to respond, usually because you do not have access or permission to the requested resource.
404The requested resource doesn’t exist.
422The request body was well-formed but contains semantic errors (e.g. insufficient points balance). Refer to the response body for further information.
429Your API token has exceeded its rate limit.
500An internal error occurred in Yuko. Retry your request. If the issue persists, contact Yuko support.
503The server is currently unavailable.