---
title: "Gets a contract job's custom fields (BF-7519)."
method: GET
path: "/v{version}/ContractJobs/{jobId}/customFields"
tags: ["ContractJobs"]
---

# Gets a contract job's custom fields (BF-7519).

`GET /v{version}/ContractJobs/{jobId}/customFields`

Every active contract-job custom field of your company, in display order: customFieldId, name, type
("user", "list" or "freeForm"), isRequired, value (the stored list item id, user id or text; null when
empty), displayValue, and for list fields the active options. Send { customFieldId, value } back to PATCH.

## Path parameters

- `jobId` integer, required
- `version` string, required

## Headers

- `company-id` string, required

## Response `200`

Success

- ContractsContractsJobCustomFieldsContractJobCustomFieldsResponse
  - `isValid` boolean
  - `errors` string[], nullable
  - `warnings` string[], nullable
  - `info` string[], nullable
  - `message` string, nullable
  - `data` ContractsContractsJobCustomFieldsContractJobCustomFieldView[], nullable
    - `customFieldId` integer
    - `name` string, nullable
    - `type` string, nullable
    - `isRequired` boolean
    - `value` string, nullable
    - `displayValue` string, nullable
    - `options` ContractsContractsJobCustomFieldsContractJobCustomFieldOption[], nullable
      - `id` integer
      - `name` string, nullable

## Changes

- **2026-09-25** `b7986f02e1d6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bilflo/apis/bilflo-api/changes/v:version/ContractJobs/:jobId/customFields/get.md)

---

[API](https://skmtc.dev/bilflo/apis/bilflo-api.md) · [All operations](https://skmtc.dev/bilflo/apis/bilflo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bilflo/apis/bilflo-api/revisions/5063eab95b17?raw)