---
title: "Fetch custom field"
method: GET
path: "/custom_fields/{custom_field_id}"
tags: ["custom_fields"]
---

# Fetch custom field

`GET /custom_fields/{custom_field_id}`

Returns the matching custom field.

## Response `200`

Successful response

- AssignmentPercentAllocation — An assignment set to a percentage of the resource's time.
  - `allocation_mode` 'percent', required — This indicates that a percentage of the resource's time is allocated to the corresponding assignment.
  - `percent` number, required — The percentage of time the resource is allocated to the corresponding assignment. **Note:** This property is only present when `allocation_mode` is `"percent"`.
  - `id` integer — The unique identifier for the assignment.
  - `user_id` integer — The ID of the user this assignment belongs to.
  - `assignable_id` integer — The ID of the project, phase, or leave type to which the the assignment applies.
  - `starts_at` string, date, required — The assignment's effective start date.
  - `ends_at` string, date, required — The assignment's effective end date.
  - `repetition_id` integer, nullable — A unique identifier for a series of repeating assignments. If the assignment is part of a repeating series, this is the parent assignment's unique ID. Otherwise, it's null. **Note:** This ID is the same for all assignments within the same repeating series.
  - `created_at` string, date-time — The time of creation.
  - `updated_at` string, date-time — The time of the last update.
  - `all_day_assignment` boolean
  - `resource_request_id` integer, nullable
  - `bill_rate` number, nullable — The cost value.
  - `bill_rate_id` integer, nullable
  - `status` unknown
  - `status_option_id` integer, nullable — The ID of the status option associated with the assignment.
  - `description` string — Describes the assignment.
  - `note` boolean, nullable — Calls out ancillary information about the assignment.

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/resource-management-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/resource-management-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/resource-management-openapi-reference/versions/e4c439ac13f2/schema)