Introduction

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.