---
title: "Get Sites"
method: GET
path: "/entities/site"
tags: ["3. Sites"]
---

# Get Sites

`GET /entities/site`

Retrieve sites, optionally filtering by MPAN or postcode.

Returns a page of sites with the total count and the requested subset of site records. Use the limit and offset parameters to navigate through pages of results.

## Query parameters

- `mpan` string — Filter sites by MPAN
- `postcode` string — Filter sites by postcode
- `limit` integer — Maximum number of sites to return (1-5000)
- `offset` integer — Number of sites to skip for pagination

## Response `200`

Successful Response

- SiteResponsePage — Paginated response for site listings.
  - `sites` SiteResponse[], required — List of sites for the current page
    - `id` string, uuid, required — Axle's internal UUID for the site
    - `mpan` string — Meter Point Administration Number for the site
    - `postcode` string — UK postcode for the site
    - `address` string — Full address for the site
    - `asset_ids` string[] — List of asset IDs associated with this site
    - `markets` MarketResponse[] — Markets the site is participating in
    - `dispatch_methods` DispatchMethodResponse[] — Dispatch methods allowed for the site
    - `tariff` TariffResponse — Response model for tariff information.
      - `tariff_type` 'single_rate' | 'dual_rate' | 'dynamic' | 'smart' | 'unknown' — An enumeration.
      - `tariff_cheap_start_time` string, time — Start time for off-peak/cheap rate period
      - `tariff_cheap_end_time` string, time — End time for off-peak/cheap rate period
    - `gave_boundary_meter_consent_at` string, date-time — Timestamp when boundary meter consent was given
  - `total_num_sites` integer, required — Total number of sites available
  - `total_num_pages` integer, required — Total number of pages available
  - `page_number` integer, required — Current page number (1-based)

## Other responses

- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/axle/apis/axle-api-docs.md) · [All operations](https://skmtc.dev/axle/apis/axle-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axle/axle-api-docs/revisions/75be7f9a952f/schema)