---
title: "List Fields"
method: GET
path: "/fields"
---

# List Fields

`GET /fields`

## Request

- Base URL: `https://api.mapsharvest.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mapsharvest.com/fields`
- Auth: none declared

Return the v2 field catalog + presets so the frontend can build its picker.

Stays usable unauthenticated (it is just a catalog), but when a caller does
present credentials we also return the fields THEIR plan is entitled to.
The picker needs that to default to "everything I can actually get" rather
than pre-ticking fields the backend will silently drop — which is how the
Starter plan ended up advertising `hours` it could never deliver.

Entitlement is resolved through plan_benefits, the same admin-editable
table clamp_fields_to_plan() uses, so the picker cannot drift from
enforcement.

## Headers

- `authorization` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mapsharvest/apis/google-maps-scraper-api.md) · [All operations](https://skmtc.dev/mapsharvest/apis/google-maps-scraper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsharvest/apis/google-maps-scraper-api/revisions/e564e15bb415?raw)