---
title: "List Transaction Custom Fields"
method: GET
path: "/v1.0/transaction/customfields"
tags: ["Lead Transaction"]
---

# List Transaction Custom Fields

`GET /v1.0/transaction/customfields`

Returns the team-level custom field definitions applicable to transactions. Use the returned ids when populating LeadTransaction.customFields on create / update.

Scope: the caller's team.

## Headers

- `Authorization` string, required

## Response `200`

List of custom field definitions (may be empty).

- CustomFieldResponse[]
  - `id` integer — Custom field id.
  - `name` string — Custom field display name.
  - `type` 'DATE' | 'TEXT' | 'NUMBER' | 'PERCENTAGE' | 'Single-Select' | 'Multi-Select' | 'CURRENCY' | 'HTML' — Custom field data type. Note the mixed casing: Single-Select and Multi-Select are emitted with hyphens and mixed case, while the other values are the upper-case enum names.
  - `params` string — For Single-Select and Multi-Select types, a JSON string encoding the option list, e.g. "[{\"label\":\"Option A\",\"value\":\"1\"},{\"label\":\"Option B\",\"value\":\"2\"}]". Empty or null for non-select types.

## Other responses

- `401` — Missing or invalid authentication token.
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/versions/23e640467118/schema)