---
title: "Get Field Schemas for an Entity"
method: GET
path: "/v1/schemas/{entity}"
tags: ["Schemas"]
---

# Get Field Schemas for an Entity

`GET /v1/schemas/{entity}`

Lists fields for `entity`, which must be one of `accounts`, `contacts`, `meetings`, `opportunities`, `sequences`, or `tasks`.

Use each entry's `key` in `filters[].field` and `sort` on the corresponding list endpoint. The `allowed_operators` array lists the valid values for `filters[].condition` on that field.

Custom fields use `custom_field_{uuid}` keys. Enum and select fields expose their accepted values under `enum_field_settings.allowed_values`, and callers must pass the `key` rather than the display value.

For `date` and `datetime` fields the `allowed_values` are semantic periods used with the `is` operator. The `equals`, `greater_than`, and `less_than` operators take raw `YYYY-MM-DD` values instead.

## Path parameters

- `entity` string, required

## Response `200`

Successful Response

- PublicItemResponseListFieldSchemaResponse
  - `data` FieldSchemaResponse[], required
    - `name` string, required — Display name of the field
    - `key` string, required — Internal key used for filtering and sorting
    - `type` 'string' | 'number' | 'time' | 'boolean' | 'enum' | 'array' | 'date' | 'datetime' | 'text' | 'uuid' | 'object', required — Data type of the field
    - `parent` string, nullable — The key of the parent object field this field belongs to. For example, 'employee_count' has parent 'company'. Top-level fields have no parent.
    - `filterable` boolean, required — Whether this field can be used in filter rules on list endpoints
    - `sortable` boolean, required — Whether this field can be used for sorting on list endpoints
    - `allowed_operators` string[], required — Operators that can be used to filter this field
    - `custom_field_settings` CustomFieldSettings — Settings present only for custom fields.
      - `id` string, required — Unique identifier of the custom field schema
      - `is_ai_auto_filled` boolean, required — Whether this custom field is automatically populated by AI
    - `enum_field_settings` EnumFieldSettings — Settings present only for enum/select fields.
      - `allowed_values` EnumValueOption[], required — The list of valid values that can be used in filters
        - `key` string, required — The value to use in filter rules
        - `display_value` string, required — Human-readable label for the value
  - `meta` ResponseMeta
    - `timestamp` string, date-time — Server timestamp of the response

## Other responses

- `4XX` — Client error

---

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