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

# REST API Overview: Base URL, Versioning, and Rate Limits

> Overview of the Nexenergie REST API: base URL, versioning, request conventions, rate limits, and pagination for electricity price forecast endpoints.

All HTTP routes live under `/api/v1`.

```bash theme={null}
https://<host>/api/v1
```

Health checks do not require auth: `GET /health` and `GET /ready`.

## Surfaces

<CardGroup cols={2}>
  <Card title="Client API" icon="plug" href="/api-reference/forecasts/day-ahead">
    Stable payloads for OMS, scripts, and partners. Markets and forecasts.
  </Card>

  <Card title="App API" icon="browser">
    Used by the web app. Auth, dashboard, portfolio, webhooks, and admin.
  </Card>
</CardGroup>

<AccordionGroup>
  <Accordion title="Client routes">
    * `GET /markets`
    * `GET /markets/{market_id}`
    * `GET /markets/{market_id}/products`
    * `GET /forecasts/latest`
    * `GET /forecasts`
  </Accordion>

  <Accordion title="App routes">
    * `/auth` — register, login, users, invitations, API keys
    * `/dashboard` — charts, drivers, weather, accuracy
    * `/portfolio` — sites
    * `/webhooks` — endpoints and deliveries
    * `/notifications`, `/settings`, `/statistics`, `/support`
    * `/admin` — superadmin only
  </Accordion>
</AccordionGroup>

## Conventions

<AccordionGroup>
  <Accordion title="Auth">
    `Authorization: Bearer <jwt or nex_...>`
  </Accordion>

  <Accordion title="Errors">
    `{ "detail": "..." }` or FastAPI validation `{ "detail": [ ... ] }`
  </Accordion>

  <Accordion title="Pagination">
    `Page` objects (`items`, `total`, …) on list endpoints that support it
  </Accordion>

  <Accordion title="Time and units">
    UTC ISO-8601 unless a parameter is a local delivery `date`. Prices are EUR/MWh.
  </Accordion>
</AccordionGroup>

<Tip>
  Prefer the client API for integrations. Use dashboard routes only if you are rebuilding the UI.
</Tip>