> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Understand general concepts, response codes, and authentication strategies.

## Base URL

The Nomos API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy. The API does not support HTTP.

All requests contain the following base URL:

```
https://api.nomos.energy
```

<Note>
  When using the sandbox for testing, take: `https://api.sandbox.nomos.energy`
</Note>

## Resources

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-references/authentication">
    Get a Bearer token using OAuth 2.0.
  </Card>

  <Card title="Versioning" icon="code-branch" href="/api-references/versioning">
    Pin a version per Auth Client or per request.
  </Card>

  <Card title="Pagination" icon="arrow-right" href="/api-references/pagination">
    Walk list endpoints with cursor-based pagination.
  </Card>

  <Card title="Filtering" icon="filter" href="/api-references/filtering">
    Narrow lists with bracket-notation query filters.
  </Card>

  <Card title="Errors" icon="circle-exclamation" href="/api-references/errors">
    Decode the error envelope and handle each code.
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="/api-references/changelog">
    See what changed between API versions.
  </Card>
</CardGroup>

## Need help?

Email [support@nomos.energy](mailto:support@nomos.energy) and include the `requestId` from the error response.