---
title: "Retrieves a specific custom field by its key."
method: GET
path: "/dx/api/people/v1/customFields/{key}"
tags: ["People / Custom fields"]
---

# Retrieves a specific custom field by its key.

`GET /dx/api/people/v1/customFields/{key}`

Fetches the details of a single custom field by its unique key. This endpoint is useful for retrieving the configuration and metadata for individual custom fields.

## Response `200`

Custom field retrieved successfully.

## Other responses

- `401` — Unauthorized. The request is missing a valid session.
- `404` — Custom field not found.

## Changes

- **2025-03-19** `2267cfc94cf0` — 2 breaking
  - removed the media type `*/*` for the response with the status `200`
  - removed the media type `exampleCustomField` for the response with the status `200`
- **2025-03-19** `355f7332f550` — 2 info
  - added the media type `*/*` for the response with the status `200`
  - added the media type `exampleCustomField` for the response with the status `200`

[Change history](https://skmtc.dev/hcl-tech-software/apis/people-api-v1-server/changes/dx/api/people/v1/customFields/:key/get.md)

---

[API](https://skmtc.dev/hcl-tech-software/apis/people-api-v1-server.md) · [All operations](https://skmtc.dev/hcl-tech-software/apis/people-api-v1-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hcl-tech-software/people-api-v1-server/revisions/2267cfc94cf0/schema)