---
title: "List custom fields"
method: GET
path: "/v1/fields"
tags: ["Fields"]
---

# List custom fields

`GET /v1/fields`

List custom fields under the same account

## Query parameters

- `field_id[]` string[], nullable
- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

List custom fields response

- PageField
  - `next_cursor` string, nullable
  - `items` Field[], required
    - `brex_id` string, required — The internal Brex ID of the field
    - `name` string, nullable, required — The name of the field
    - `remote_id` string, nullable — Remote/external ID of custom field from external system (e.g. ERP or HRIS system)
    - `updated_at` string, date-time, required — The last updated timestamp of the field
    - `is_disabled` boolean, required — Indicates whether the field is disabled. A disabled field is not selectable: it is no longer offered as an option in the Brex dropdown and cannot be applied to new transactions. Records that already reference the field are unaffected.
    - `group` 'ACCOUNTING' | 'USER' | 'ERP' | 'TRAVEL', nullable — The category of the field, indicating its purpose or context. For example, it could belong to accounting-related fields or user-related fields.

## Other responses

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

---

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