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.