---
title: "Grid Region Map Geometry"
method: GET
path: "/v3/maps"
tags: ["GET Regions and Maps"]
---

# Grid Region Map Geometry

`GET /v3/maps`

Provides a geojson of the grid region boundary for all regions that WattTime covers globally. Check when the geojson was last updated using the `last_updated` value in the `meta` object of the geojson. Access to this endpoint is restricted to customers with ANALYST or PRO subscriptions. The response is a geojson response, that is a Feature Collection with properties that describe each region, and multipolygon geometry made up of coordinates which define the boundary for each region. The `meta` object contains the date-time that the geojson was last updated and the associated `signal_type`.

## Query parameters

- `signal_type` union, required — Use to select any available `signal_type` which is authorized for your account
  - 'co2_moer' | 'health_damage'
  - 'co2_aoer'
  - unknown

## Response `200`

Successful Response

- Map
  - `type` 'FeatureCollection', required
  - `features` Feature[], required
    - `type` 'Feature', required
    - `properties` Properties, required
      - `region` string, required
      - `region_full_name` string, required
    - `geometry` Geometry, required
      - `type` 'MultiPolygon', required
      - `coordinates` array[], required
        - array[]
          - array[]
            - number[]
  - `meta` Meta, required
    - `last_updated` string, date-time, required
    - `signal_type` union, required
      - 'co2_moer' | 'health_damage'
      - 'co2_aoer'
      - unknown

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.dev/watttime/apis/watttime-data-api.md) · [All operations](https://skmtc.dev/watttime/apis/watttime-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/watttime/watttime-data-api/revisions/2c85341b2839/schema)