---
title: "Get a custom field definition"
method: GET
path: "/public/v1/custom-fields/{id}"
tags: ["CustomField"]
---

# Get a custom field definition

`GET /public/v1/custom-fields/{id}`

Get one custom field definition by its numeric id, scoped to the authenticated company.

Use this to resolve a field's current type, options, and settings — for example before writing a value into an entity's `custom_data`, where this same id is the map key. Returns 404 when no field with that id belongs to the company (a field owned by another company is indistinguishable from one that does not exist). Read-only; touches nothing in inventory or compliance.

Required permission: `settings_permissions_custom_fields`.

## Path parameters

- `id` integer, required

## Response `200`

A single custom field definition

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission
- `404` — Not Found

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/f8930b2c2924/schema)