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

# Quickstart: Your First Voltpath API Request

> Learn how to fetch day-ahead electricity prices from the Voltpath API for a single bidding zone in under five minutes.

This guide walks you through making your first request to the Voltpath API. In a few minutes, you will retrieve day-ahead electricity prices for Germany for the past seven days and understand how the API structures its responses.

<Steps>
  <Step title="Choose your base URL">
    The Voltpath API is hosted at the following base URL. No API key or authentication is required based on the current specification.

    ```text theme={null}
    https://api.voltpath.ai
    ```
  </Step>

  <Step title="Fetch day-ahead prices">
    Send a GET request to `/api/v1/prices` with query parameters to filter by bidding zone, time range, and resolution.

    <CodeGroup>
      ```bash cURL theme={null}
      curl 'https://api.voltpath.ai/api/v1/prices?zone=DE&datetime_from=now-7d&datetime_to=now&resolution=1D'
      ```

      ```python Python theme={null}
      import httpx

      resp = httpx.get(
          'https://api.voltpath.ai/api/v1/prices',
          params={
              'zone': 'DE',
              'datetime_from': 'now-7d',
              'datetime_to': 'now',
              'resolution': '1D'
          }
      )
      print(resp.json())
      ```
    </CodeGroup>
  </Step>

  <Step title="Read the response">
    All Voltpath endpoints return data inside a standard envelope. The `meta` object contains provenance information, the resolved time range, and upstream data sources. The `data` array holds the result rows.

    ```json theme={null}
    {
      "meta": {
        "provenance": "measured",
        "resolution": "1D",
        "resolved_datetime_from": "2026-08-19T00:00:00",
        "resolved_datetime_to": "2026-08-26T00:00:00",
        "upstream_sources": ["ENTSO-E Transparency Platform"]
      },
      "data": [
        {"datetime": "2026-08-19T00:00:00", "bidding_zone": "DE", "price_mwh": 82.45, "interpolated": false, "year": 2026},
        {"datetime": "2026-08-20T00:00:00", "bidding_zone": "DE", "price_mwh": 79.10, "interpolated": false, "year": 2026}
      ]
    }
    ```

    Each row in the `data` array is a `PriceRow` containing the timestamp, bidding zone code, day-ahead price in EUR per MWh (`price_mwh`), an interpolation flag, and the year.
  </Step>

  <Step title="Filter by multiple zones">
    To retrieve data for more than one bidding zone, repeat the `zone` query parameter for each code.

    ```bash theme={null}
    curl 'https://api.voltpath.ai/api/v1/prices?zone=DE&zone=FR&datetime_from=now-7d&datetime_to=now&resolution=1D'
    ```
  </Step>
</Steps>

<Tip>
  Use `resolution=auto` (the default) and let the server select the most appropriate granularity for your requested time range.
</Tip>

## Next steps

<CardGroup>
  <Card title="Bidding zones" icon="map" href="/concepts/bidding-zones">
    Learn how European bidding zones work and how to use zone codes in your queries.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Explore all available endpoints, parameters, and response schemas.
  </Card>
</CardGroup>