> ## Documentation Index
> Fetch the complete documentation index at: https://terminal49-vorflux-dev-12120-supported-document-types.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List custom fields

> List custom field value records across your account in the Terminal49 API, with filters for definition slug, target resource type, and resource ID.

Use this endpoint to retrieve custom field values attached to your shipments and containers. Custom fields let you store additional metadata on entities to support your business workflows.

## Query filters

Filter results using these query parameters:

| Filter                  | Description                                       |
| ----------------------- | ------------------------------------------------- |
| `filter[entity_type]`   | Filter by entity type (`Shipment` or `Container`) |
| `filter[entity_id]`     | Filter by the ID of the shipment or container     |
| `filter[definition_id]` | Filter by custom field definition ID              |

## Response

The response includes:

* `value` - The raw stored value
* `display_value` - Formatted value for display (e.g., formatted numbers, date strings, enum labels)
* Relationships to the entity, definition, and user who last updated the field