> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Order Custom Fields

## Methods

* [order\_custom\_field.list](#order-custom-field-list)

***

## Entity Properties

* [Order Custom Field](#field-properties)
* [Order Custom Field Option](#option-properties)

***

## Additional Resources

* [Order Custom Fields](/merchant-api/order#order-custom-field) — when submitting/receiving Order info.
* [UI Order Custom Fields article](https://help.shipstream.io/article/0hv4sjkn3d-custom-fields-for-orders)

***

## `order_custom_field.list`

`order_custom_field.list()`

Retrieve list of order custom fields available for the calling merchant.

### Return Value

An array of objects. Each object will contain [Order Custom Field](#field-properties) properties.

### Example Request

```json title="Request" theme={null}
{
    "jsonrpc" : 2.0,
    "id"      : 1234,
    "method"  : "call",
    "params"  : [
        "34aa989befe360d67fe3f70b3517a1e5",
        "order_custom_field.list"
    ]
}
```

### Example Response

```json title="Response" theme={null}
{
    "result": [
        {
            "custom_field_id": "3",
            "name": "Original Purchase Date",
            "code": "purchase_date",
            "is_active": "1",
            "input_type": "date",
            "is_required": "0",
            "client_note": null,
            "client_permissions": "restricted",
            "is_display_client_grid": "1",
            "is_display_client_form": "0",
            "sort_order": "0",
            "created_at": "2022-07-01T10:46:16+00:00",
            "updated_at": "2022-07-01T10:46:16+00:00"
        },
        {
            "custom_field_id": "4",
            "name": "Main Item SKU",
            "code": "main_sku",
            "is_active": "1",
            "input_type": "text",
            "is_required": "0",
            "client_note": null,
            "client_permissions": "unrestricted",
            "is_display_client_grid": "0",
            "is_display_client_form": "1",
            "sort_order": "99",
            "created_at": "2022-07-01T11:43:28+00:00",
            "updated_at": "2022-07-01T11:43:28+00:00"
        }
    ],
    "id": "1234",
    "jsonrpc": "2.0"
}
```

## Entity Properties

### Order Custom Field Properties

<Expandable title="Order Custom Field Properties">
  <ParamField path="custom_field_id" type="integer">
    An automatically generated unique identifier for an Order Custom Field.
  </ParamField>

  <ParamField path="name" type="string">
    The "name" property.
  </ParamField>

  <ParamField path="code" type="string">
    The "code" property.
  </ParamField>

  <ParamField path="is_active" type="integer">
    Flag whether Order Custom Field is active.
  </ParamField>

  <ParamField path="input_type" type="string">
    The "input\_type" property. Allowed values: "text", "multiline-text", "number", "currency", "select", "multiselect", "boolean", "date", "client-user", "admin-user", "email", "url".
  </ParamField>

  <ParamField path="is_required" type="integer">
    Flag whether Order Custom Field is required.
  </ParamField>

  <ParamField path="client_note" type="string">
    The "client\_note" property.
  </ParamField>

  <ParamField path="client_permissions" type="string">
    The "unrestricted" property. Allowed values: "unrestricted", "restricted", "read-only", "hidden".
  </ParamField>

  <ParamField path="is_display_client_grid" type="integer">
    Flag whether Order Custom Field is displayed in the client grid.
  </ParamField>

  <ParamField path="is_display_client_form" type="integer">
    Flag whether Order Custom Field is displayed in the client form.
  </ParamField>

  <ParamField path="sort_order" type="integer">
    The "sort\_order" property.
  </ParamField>

  <ParamField path="created_at" type="string">
    The "Created At" property.
  </ParamField>

  <ParamField path="updated_at" type="string">
    The "Updated At" property.
  </ParamField>

  <ParamField path="options" type="array">
    Array of options. See [Option Properties](#option-properties).
  </ParamField>
</Expandable>

### Order Custom Field Option Properties

<Expandable title="Order Custom Field Option Properties">
  <ParamField path="option_id" type="integer">
    The internal option ID.
  </ParamField>

  <ParamField path="label" type="string">
    The "Label" property.
  </ParamField>

  <ParamField path="is_default" type="integer">
    Flag whether option is default.
  </ParamField>

  <ParamField path="sort_order" type="integer">
    The "Sort Order" property.
  </ParamField>
</Expandable>