Skip to main content
The Nomos API uses standardized error responses to help you quickly identify and troubleshoot issues. Nomos uses standard HTTP codes to indicate the success or failure of your requests.
  • 2xx codes correspond to success
  • 4xx codes are for user-related failures
  • 5xx codes are for infrastructure issues
Each error response includes:
  • A machine-readable code identifying the error type
  • A human-readable message explaining what went wrong
  • A docs URL linking to detailed documentation about the error
  • A unique requestId for tracking and debugging
When reporting issues, always include the requestId to help us investigate more effectively. 
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "We were unable to authorize your request.",
    "docs": "https://docs.nomos.energy/api-references/errors/code/BAD_REQUEST",
    "requestId": "37a04f8f-e791-491c-81e1-86cd304649bb"
  }
}
If you can’t debug something on your own or think there is a bug, please get in touch with us on Email and provide the full error response.