Error Codes

All API errors return a consistent JSON format:

{
  "error": "Not Found",
  "message": "Resume not found",
  "statusCode": 404
}

HTTP Status Codes

Code	Name	Description
`200`	OK	Request succeeded
`201`	Created	Resource created successfully
`400`	Bad Request	Invalid request body or parameters
`401`	Unauthorized	Missing or invalid API key
`402`	Payment Required	No credits remaining — buy more or wait for monthly reset
`404`	Not Found	Resource doesn't exist
`413`	Payload Too Large	File upload exceeds 10MB limit
`422`	Unprocessable Entity	Valid JSON but semantically invalid (e.g., job description too short)
`429`	Too Many Requests	Rate limit exceeded — retry after the `Retry-After` header value
`500`	Internal Server Error	Something went wrong on our end

{
  "error": "Unauthorized",
  "message": "Missing x-api-key header",
  "statusCode": 401
}

Fix: Add your API key to the x-api-key header.

{
  "error": "Unauthorized",
  "message": "Invalid API key",
  "statusCode": 401
}

Fix: Check your key at console.laddro.com. Keys may have been revoked.

{
  "error": "Payment Required",
  "message": "No credits remaining. Purchase credits at console.laddro.com",
  "statusCode": 402
}

Fix: Buy a credit pack or wait for your monthly free tier reset.