Error Responses
Standard error response format with status codes.
Updated
On this page
Error Format
All errors return a consistent JSON structure:
{
"error": "not_found",
"message": "Product not found",
"details": "No product with slug 'nonexistent'"
}
HTTP Status Codes
| Status | Meaning |
|---|---|
| 200 | Success |
| 201 | Created (new resource) |
| 400 | Bad Request (invalid input) |
| 401 | Unauthorized (missing or invalid auth) |
| 403 | Forbidden (insufficient permissions) |
| 404 | Not Found |
| 429 | Rate Limited |
| 500 | Internal Server Error |
| 503 | Maintenance Mode |
Error Codes Reference
See Error Codes for the full list of error codes and their meanings.
Handling Errors
const response = await fetch(url, { headers: { "X-API-Key": key } })
if (!response.ok) {
const error = await response.json()
console.error(error.error, error.message)
// Handle based on status code
}
Next Steps
- Rate Limiting — Request limits
- Error Codes — Full error reference