---
title: "Grid section"
method: GET
path: "/grid-section"
tags: ["what3words API"]
---

# Grid section

`GET /grid-section`

## Request

- Base URL: `https://api.what3words.com/v3`
- URL: `https://api.what3words.com/v3/grid-section`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `X-Api-Key`

Returns a section of the 3m x 3m what3words grid for a bounding box. The bounding box is specified by lat,lng,lat,lng as south,west,north,east. You can request the grid in GeoJSON format, making it very simple to display on a map.

## Query parameters

- `key` string
- `bounding-box` string, required
- `format` 'json' | 'geojson'

## Response `200`

Successful grid section retrieval

- GridSectionResponse
  - `lines` object[]: Array of line objects that make up the grid
    - `start` Coordinates
      - `lat` number, double: Latitude
      - `lng` number, double: Longitude
    - `end` Coordinates
      - `lat` number, double: Latitude
      - `lng` number, double: Longitude

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid API key

## Changes

- **2026-03-04** `89db2437e8b6`: 10 warning, 4 info
  - added the new `BadInput` enum value to the `error/code` response property for the response status `401`
  - added the new `BadInput` enum value to the `items/error/code` response property for the response status `400`
  - added the new `BadNFocusResults` enum value to the `error/code` response property for the response status `401`
  - added the new `BadNFocusResults` enum value to the `items/error/code` response property for the response status `400`
  - …10 more

[Operation history](https://skmtc.dev/what3words/apis/what3words-api/changes/grid-section/get.md)

---

[API](https://skmtc.dev/what3words/apis/what3words-api.md) - [All operations](https://skmtc.dev/what3words/apis/what3words-api/llms.txt) - [OpenAPI document](https://skmtc.dev/what3words/apis/what3words-api/revisions/2f8f54251ad7?raw)
