Error Reference

This section outlines the standard error responses you may encounter when using the Orca API.

Error Response Format

All API errors follow a consistent JSON structure:


{
  "error": {
    "type": "ERROR_TYPE",
    "message": "Human-readable error description (optional)",
    "details": ["Additional error details (optional)"]
  },
  "timestamp": 1755602195137
}

HTTP Status Codes

Status Code	Description
`400`	Bad Request - Invalid request format or validation failed
`401`	Unauthorized - Authentication required or invalid credentials
`403`	Forbidden - Access denied (usually due to Firewall) - contact support in this case
`404`	Not Found - Resource not found
`429`	Too Many Requests - Rate limit exceeded
`500`	Internal Server Error - Server-side error occurred

Error Types

VALIDATION_ERROR (400)

Request validation failed due to invalid or missing required fields.

In the case of failed validation, the details section will include information about the failed field/s with reason details, for example:


{
    "error": {
        "type": "VALIDATION_ERROR",
        "message": "Request validation failed",
        "details": [
            "/amount: Expected number to be greater or equal to 0"
        ]
    },
    "timestamp": 1755602195137
}

AUTHENTICATION_ERROR (401)

Invalid or missing API key.


{
    "error": {
        "type": "AUTHENTICATION_ERROR",
        "message": "Invalid API Key",
    },
    "timestamp": 1755602195137
}

SERVER_ERROR (500)

Internal server error occurred during request processing.


{
    "error": {
        "type": "SERVER_ERROR",
        "message": "Failed to process transaction",
    },
    "timestamp": 1755602195137
}