---
title: "Get an employee's custom fields"
method: GET
path: "/v1/employees/{employee_id}/custom_fields"
tags: ["Employees"]
---

# Get an employee's custom fields

`GET /v1/employees/{employee_id}/custom_fields`

Returns a list of the employee's custom fields.

scope: `employees:read`

## Path parameters

- `employee_id` string, required

## Query parameters

- `page` integer
- `per` integer

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Success

- EmployeeCustomFieldList — A list of an employee's custom fields
  - `custom_fields` EmployeeCustomField[]
    - `id` string, required
    - `company_custom_field_id` string, required — This is the id of the response object from when you get the company custom fields
    - `name` string, required
    - `type` 'text' | 'currency' | 'number' | 'date' | 'radio', required — Input type for the custom field.
    - `description` string, nullable
    - `value` string, required
    - `selection_options` string[], nullable — An array of options for fields of type radio. Otherwise, null.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)