---
title: "Search for parcels"
method: POST
path: "/parcels/search"
tags: ["Parcels"]
---

# Search for parcels

`POST /parcels/search`

Given a region GSS code and optional parcel size, retrieve a list of parcel IDs. The maximum number of IDs returned is 100,000.

## Request body

- ParcelSearchRequest
  - `region` string, required — A region code (e.g. GSS code for UK Local Authority Districts).
  - `parcel_size` object — An optional filter for parcel size in square metres. The max or min can be omitted, so for example to find parcels larger than 1ha (10,000sqm) you can use {"min": 10000}.
    - `min` number, float — The minimum parcel size in square metres.
    - `max` number, float — The maximum parcel size in square metres.
  - `tenure` string[]

## Response `200`

A list of parcel IDs matching the search criteria.

- ParcelIds
  - `parcel_ids` ParcelId[], required — A list of parcel UUIDs.

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/land/apis/landtech-api.md) · [All operations](https://skmtc.net/land/apis/landtech-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/land/landtech-api/revisions/4608786ac394/schema)