---
title: "Full current-state snapshot"
method: GET
path: "/v1/map/snapshot"
---

# Full current-state snapshot

`GET /v1/map/snapshot`

## Request

- Base URL: `https://api.grid-hub.app`
- URL: `https://api.grid-hub.app/v1/map/snapshot`
- Auth: none declared

Every covered zone's latest metrics in one call. Priced at $0.002 per call, payable via x402 (USDC on Base), or free with ?sample=true.

## Query parameters

- `sample` boolean

## Response `200`

Success

- object
  - `generated` integer
  - `zones` object

## Other responses

- `402`: Payment required — see the PAYMENT-REQUIRED header for x402 v2 payment details.
- `404`: Unknown zone.

---

[API](https://skmtc.dev/grid-hub/apis/gridhub-electricity-data-api.md) · [All operations](https://skmtc.dev/grid-hub/apis/gridhub-electricity-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grid-hub/apis/gridhub-electricity-data-api/revisions/7e97d17a9872?raw)