---
title: "Get list of transaction custom fields"
method: GET
path: "/v3/spend/transactions/{transactionId}/custom-fields"
tags: ["transactions"]
---

# Get list of transaction custom fields

`GET /v3/spend/transactions/{transactionId}/custom-fields`

Get a list of custom field objects applied to an existing transaction.

## Path parameters

- `transactionId` string, required — BILL-generated ID or UUID of the transaction

## Query parameters

- `filters` string, nullable — Field name, operator, and value. You can set multiple filters. The format is `filters={field_01}:{op}:{value},{field_02}:{op}:{value}`. Example: `filters=customFieldIds:in:"abc,def"` The filterable fields are: - `customFieldIds` - List of string IDs or UUIDs. Operators: `eq`, `in`.

## Headers

- `apiToken` string, nullable — Access token for Spend & Expense API authentication

## Response `200`

Get list of transaction custom fields response

- ListTransactionCustomFieldResponseDto — Transaction custom field response list.
  - `results` CustomFieldDto[] — Results
    - `id` string — BILL-generated ID of the custom field
    - `uuid` string — BILL-generated UUID of the custom field
    - `name` string — Custom field name
    - `note` string — Custom field note
    - `isRequired` boolean — Set as `true` if the custom field is required
    - `selectedValues` CustomFieldValueDto[] — List of selected values for this custom field. **NOTE**: In the response, you get up to 20 selected values for a custom field. Use `GET /v3/spend/custom-fields/{customFieldId}/values` to get the complete list of selected values.
      - `id` string — BILL-generated ID of the custom field value
      - `uuid` string — BILL-generated UUID of the custom field value
      - `value` string — Custom field value

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/versions/0483350c434e/schema)