v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
CustomFields > Field

Reads a single Field

Reads a single Field

get/api/2026-07-01/resources/custom_fields/fields/{id}

Path parameters

idstring required

Field identifiers

Response

OK

idstring required

Field identifier

field_type'text' | 'long_text' | 'date' | 'rating' | 'checkbox' | 'single_choice' | 'multiple_choice' | 'money' | 'cents' required

The type of the field's value

label_textstring required

Field label

positioninteger

Field position within employee profile

requiredboolean

Requirement to fill this field

min_valueinteger

Minimum value in range field type

max_valueinteger

Maximum value in range field type

legal_entity_namestring

Legal entity name where this field belongs

legal_entity_idstring

Legal entity id where this field belongs

slugstring

Custom field slug

Example response

{
  "id": "2",
  "field_type": "text",
  "label_text": "T-Shirt Size",
  "position": 3,
  "required": true,
  "min_value": 10,
  "legal_entity_name": "Factorial Legal",
  "legal_entity_id": "1",
  "slug": "tshirt_size"
}