---
title: "List Fetch fields"
method: GET
path: "/v1/meta/fields"
---

# List Fetch fields

`GET /v1/meta/fields`

## Request

- Base URL: `https://api.mireye.com`
- URL: `https://api.mireye.com/v1/meta/fields`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mireye/apis/mireye-earth/docs/v1/meta/fields/get.ts> (a function with typed inputs; its response is checked against the schema)

Every field and preset available to POST /v1/fetch, with type, unit, description, interpretation hints, null meaning, source and citation. No authentication is required. The response carries an ETag and Cache-Control: public, max-age=3600; send If-None-Match to receive 304 when nothing changed. Enrich and Search have their own field lists at GET /v1/enrich/fields and GET /v1/search/fields.

## Response `200`

Successful Response

- FetchCatalogResponse
  - `billing` Billing, required
    - `currency` 'USD', required
    - `price_usd` string, required: Decimal USD string.
    - `unit` string, required: What one charge covers.
  - `contract` string, required
  - `fields` FetchCatalogField[], required
    - `billing` Billing, required
      - `currency` 'USD', required
      - `price_usd` string, required: Decimal USD string.
      - `unit` string, required: What one charge covers.
    - `derivation` object, nullable, required: Formula, version and input fields for a field composed from others.
    - `description` string, required
    - `interpretation_hints` string, nullable, required
    - `layer` string, required: Data layer the field belongs to.
    - `name` string, required
    - `null_meaning` string, nullable, required
    - `nullable` boolean, required
    - `presets` string[], required: Fetch presets that include this field.
    - `source` string, nullable, required: Public source ID returned with values.
    - `source_url` string, nullable, required: Citation for the source.
    - `ttl_seconds` integer, nullable, required: How long a value stays current, in seconds.
    - `type` string, required
    - `unit` string, nullable, required
  - `presets` object, required: Fetch preset names and their fields.
  - `us_envelope` object, required: Accepted coordinate bounds.
  - `version` string, required: Response envelope version.

## Other responses

- `304`: Not modified; the cached copy matching If-None-Match is current.
- `400`: An unknown query parameter was supplied.

---

[API](https://skmtc.dev/mireye/apis/mireye-earth.md) - [All operations](https://skmtc.dev/mireye/apis/mireye-earth/llms.txt) - [OpenAPI document](https://skmtc.dev/mireye/apis/mireye-earth/revisions/d8410ba83654?raw)