latestOpenAPI 3.0.02026-08-2217901.1 MB

ef9153fcac7c

Custom Fields

List custom fields

get/customfields/{entity}

Path parameters

entity'assets' | 'locations' | 'parts' | 'workOrders' | 'vendors' | 'purchaseOrders' | 'lineItemPurchaseOrders' required

Type of entity

Headers

x-organization-idinteger

Required if using a multi organizations token

Response

Successfully fetched the custom fields

idnumber required

ID of the custom field

labelstring required

The label of the custom field

sortOrderinteger required

A weighted value used to sort the custom fields. Fields are sorted lowest to highest. This is different from sortIndex.

type'oneline' | 'multiline' | 'number' | 'singleSelect' | 'date' | 'datetime' | 'link' required
requiredboolean nullable

This field is marked as required. This only affect the frontend.

unlistedboolean nullable

This field is marked as unlisted. Once unlisted it will only be editable through the Rest API. When the custom field contains data, it will be displayed in the frontend; otherwise, it will remain hidden.

optionsstring[]

The possible choices to the field (if applicable).

Example response

[
  {
    "id": 1,
    "label": "Date Purchased",
    "sortOrder": 25
  }
]