Errors

Portkey uses conventional response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with Portkey’s servers (these are rare).

Common Errors

During request processing, you may encounter error codes from either Portkey or the LLM provider:

Status Code	Description	Source
408	Request timed out	Portkey OR Provider
412	Budget exhausted	Portkey OR Provider
429	Request rate limited	Portkey OR Provider
446	Guardrail checks failed (request denied)	Portkey
246	Guardrail checks failed (request successful)	Portkey

Provider-specific error codes are passed through by Portkey. For debugging these errors, refer to our Error Library.