---
title: "List custom field values"
method: GET
path: "/v1/fields/{field_id}/values"
tags: ["Field Values"]
---

# List custom field values

`GET /v1/fields/{field_id}/values`

List values under the same custom field

## Path parameters

- `field_id` string, required

## Query parameters

- `brex_id[]` string[], nullable
- `value_id[]` string[], nullable
- `remote_id[]` string[], nullable
- `cursor` string, nullable
- `limit` integer, nullable
- `value` string, nullable

## Response `200`

List custom field values response

- PageFieldValue
  - `next_cursor` string, nullable
  - `items` FieldValue[], required
    - `brex_id` string, required — The internal Brex ID of the field value
    - `remote_id` string, nullable — Remote/external ID of custom field value from external system (e.g. ERP or HRIS system)
    - `value_id` string, nullable — The value ID or code of the field value; Usually it is a unique identifier for the custom field value in the remote system
    - `value` string, required — The display name of the field value
    - `field_id` string, required — The ID of the parent field this value belongs to
    - `updated_at` string, date-time, required — The last updated timestamp of the field value
    - `is_disabled` boolean, required — Indicates whether the field value is disabled. A disabled value is not selectable: it no longer appears as a selectable option in the dropdown and cannot be chosen on new transactions. Records that already use the value are unaffected.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

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