Errors

The Storrik API uses standard HTTP status codes to indicate success or failure.
All error responses follow a consistent JSON structure and include helpful context when available.

Error Format

Every error response has the same base structure:

{
  "error": "string",
  "message": "optional human readable message"
}

The error field is a short machine friendly code.
The message field is a more descriptive explanation when relevant.

HTTP Status Codes

400 Bad Request

Returned when the request body is invalid or missing required fields.

Example:

{
  "error": "invalid_request",
  "message": "amount is required"
}

401 Unauthorized

Returned when the API key is missing, invalid, or revoked.

Example:

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

404 Not Found

Returned when a requested resource does not exist.

Example:

{
  "error": "not_found",
  "message": "Resource not found"
}

409 Conflict

Returned when an operation cannot be completed because of a data conflict.

Example:

{
  "error": "conflict",
  "message": "A customer with this email already exists"
}

429 Too Many Requests

Returned when you exceed your rate limit.

Example:

{
  "error": "rate_limited",
  "message": "Rate limit exceeded."
}

500 Internal Server Error

Returned when something unexpected goes wrong on our side.

Example:

internal server error