---
title: "Get a custom field."
method: GET
path: "/api/custom-fields/{id}"
tags: ["Custom Field"]
---

# Get a custom field.

`GET /api/custom-fields/{id}`

## Path parameters

- `id` string, required

## Response `200`

The custom field for the given id

- CustomFieldDto — Custom field definition.
  - `id` string, required — Unique id associated to this entity.
  - `name` string, required — Identifying name. Must be unique.
  - `label` string, required — Label name. Must be unique and cannot contain spaces.
  - `type` 'text' | 'multilineText' | 'dropdown' | 'multipleChoiceDropdown' | 'integerNumber' | 'decimalNumber' | 'floatingPointNumber' | 'boolean' | 'list' | 'date' | 'multipleChoiceUser', required
  - `module` 'item' | 'item_Make' | 'item_Buy' | 'customer' | 'vendor' | 'quote' | 'sales_Order' | 'job' | 'invoice' | 'purchase_Order' | 'receive_Order' | 'ship_Order' | 'quote_Part_LineItem' | 'sales_Order_Part_LineItem' | 'purchase_Order_Part_LineItem' | 'outsideProcessing_LineItem' | 'shipping_Part_LineItem' | 'invoice_Part_LineItem' | 'job_Operation' | 'ncr' | 'capa', required
  - `required` boolean, required — Required.
  - `options` string[], nullable — The options available (only applicable to dropdown and multiplechoicedropdown types).
  - `prepend` string, nullable — Prepended text.
  - `append` string, nullable — Appended text.
  - `helpText` string, nullable — Help information that will be visble to the user.

## Other responses

- `404` — Custom field did not exist

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)
