---
title: "Get List Custom Fields"
method: GET
path: "/v2/list/{list_id}/field"
tags: ["Custom Fields"]
---

# Get List Custom Fields

`GET /v2/list/{list_id}/field`

View the Custom Fields you have access to in a specific List.\
 \
Custom Fields scoped to specific custom task types include an `applied_objects` array on each field object. Each entry has `object_type` (`19` for custom task type) and `object_id` (the custom task type ID, matching `custom_item_id` on tasks). Use [Get Custom Task Types](https://developer.clickup.com/reference/getcustomitems) to resolve IDs to names. Fields without task-type scoping omit `applied_objects`. Workspace-scoped Custom Fields are included when querying a List.

## Path parameters

- `list_id` number, required

## Query parameters

- `include_applied_objects` boolean

## Headers

- `Content-Type` 'application/json', required

## Response `200`

- object
  - `fields` object[], required
    - `id` string, required
    - `name` string, required
    - `type` string, required
    - `type_config` object, required
      - `options` object[]
        - `id` string, required
        - `label` string
        - `color` string, nullable, required
        - `name` string
        - `value` integer
        - `type` string
        - `orderindex` integer
      - `default` union
        - integer
        - unknown
      - `precision` integer
      - `currency_type` string
      - `placeholder` string, nullable
      - `end` integer
      - `start` integer
      - `count` integer
      - `code_point` string
      - `tracking` object
        - `subtasks` boolean, required
        - `checklists` boolean, required
        - `assigned_comments` boolean, required
      - `complete_on` integer
    - `date_created` string, required
    - `hide_from_guests` boolean, required
    - `applied_objects` object[] — Present only when the Custom Field is scoped to specific custom task types. Lists which task types the field applies to. Omitted for workspace-wide or location-scoped fields.
      - `object_type` integer, required — Entity type. Use `19` for custom task type.
      - `object_id` integer, required — Custom task type ID. Matches `custom_item_id` on tasks. Use [Get Custom Task Types](https://developer.clickup.com/reference/getcustomitems) to resolve IDs to names.

---

[API](https://skmtc.net/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.net/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/versions/72216f55b952/schema)