---
title: "Get a custom field definition"
method: GET
path: "/custom_field_definitions/{id}"
tags: ["Custom Field Definitions"]
---

# Get a custom field definition

`GET /custom_field_definitions/{id}`

## Response `200`

OK

- object
  - `data` CustomFieldDefinition
    - `id` string, uuid, required
    - `type` 'custom_field_definition', required
    - `attributes` object
      - `entity_type` 'Shipment' | 'Container' | 'TrackingRequest', required
      - `api_slug` string, required
      - `display_name` string, required
      - `description` string, nullable
      - `data_type` 'short_text' | 'number' | 'date' | 'datetime' | 'boolean' | 'enum' | 'enum_multi' | 'reference', required
      - `reference_type` string, nullable
      - `validation` object, nullable
      - `default_format` string, nullable
      - `default_value` union — Raw custom field value (type depends on definition)
        - string
        - number
        - boolean
        - string[]
        - object
  - `links` LinkSelf
    - `self` string, uri

---

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