---
title: "Get dropdown options for a Person Field"
method: GET
path: "/v2/persons/fields/{fieldId}/dropdown-options"
tags: ["Persons"]
---

# Get dropdown options for a Person Field

`GET /v2/persons/fields/{fieldId}/dropdown-options`

Returns the dropdown options for a specific dropdown or ranked-dropdown field on a Person.

Use the returned dropdown option IDs when writing dropdown field values via the field update
endpoints.

## Path parameters

- `fieldId` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

OK

- DropdownOptionPaged — DropdownOptionPaged model
  - `data` DropdownOption[], required — A page of DropdownOption results
    - union
      - DropdownOptionsDropdownOption
        - `id` integer, required — Dropdown option's unique identifier
        - `text` string, required — Dropdown option text
      - DropdownOptionsRankedDropdownOption
        - `id` integer, required — Dropdown option's unique identifier
        - `text` string, required — Dropdown option text
      - DropdownOptionsStatusDropdownOption
        - `id` integer, required — Dropdown option's unique identifier
        - `text` string, required — Dropdown option text
  - `pagination` Pagination, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)