curl --request GET \
--url https://api.nohead.io/v1/fields/{field_id} \
--header 'Authorization: Bearer <token>'import { Nohead } from "@nohead/sdk"
const nohead = new Nohead()
const result = await nohead.fields.get("fld_01J9ZQ3F8X")
from nohead import Nohead
nohead = Nohead()
result = nohead.fields.get("fld_01J9ZQ3F8X")
require "nohead"
nohead = Nohead::Client.new
result = nohead.fields.get("fld_01J9ZQ3F8X")
{
"id": "fld_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"object": "field",
"collection_id": "<string>",
"name": "<string>",
"key": "<string>",
"required": true,
"multiple": true,
"position": 123,
"deleted_at": "2023-11-07T05:31:56Z",
"purge_after": "2023-11-07T05:31:56Z",
"aliases": [
{
"key": "<string>",
"expires_at": "2026-09-27T12:00:00.000Z"
}
],
"created_at": "2026-09-27T12:00:00.000Z",
"updated_at": "2026-09-27T12:00:00.000Z",
"type": "text",
"configuration": {
"description": "<string>",
"searchable": true,
"filterable": true,
"sortable": true,
"min_length": 1,
"max_length": 1,
"format": "slug",
"unique": true
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}Get a field
A field of a collection, deleted ones included (with deleted_at and
purge_after). Published-only keys can’t read deleted fields (403).
curl --request GET \
--url https://api.nohead.io/v1/fields/{field_id} \
--header 'Authorization: Bearer <token>'import { Nohead } from "@nohead/sdk"
const nohead = new Nohead()
const result = await nohead.fields.get("fld_01J9ZQ3F8X")
from nohead import Nohead
nohead = Nohead()
result = nohead.fields.get("fld_01J9ZQ3F8X")
require "nohead"
nohead = Nohead::Client.new
result = nohead.fields.get("fld_01J9ZQ3F8X")
{
"id": "fld_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"object": "field",
"collection_id": "<string>",
"name": "<string>",
"key": "<string>",
"required": true,
"multiple": true,
"position": 123,
"deleted_at": "2023-11-07T05:31:56Z",
"purge_after": "2023-11-07T05:31:56Z",
"aliases": [
{
"key": "<string>",
"expires_at": "2026-09-27T12:00:00.000Z"
}
],
"created_at": "2026-09-27T12:00:00.000Z",
"updated_at": "2026-09-27T12:00:00.000Z",
"type": "text",
"configuration": {
"description": "<string>",
"searchable": true,
"filterable": true,
"sortable": true,
"min_length": 1,
"max_length": 1,
"format": "slug",
"unique": true
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"request_id": "req_01J9ZQ3F8X5W2K7M4N6P0R1S2T",
"details": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>",
"usage": 123,
"limit": 123,
"current_revision": 123,
"record_id": "<string>",
"draft_id": "<string>"
}
]
}
}Authorizations
Project-scoped API key, e.g. nohead_sk_k7fz0a9c3m2q_<secret>, or
nohead_pk_… for a published-only key. Used by servers, CI, the CLI
and coding agents.
Path Parameters
Response
The field.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
A field, typed by its type, which also decides the options its configuration takes.
Stable field ID. Never changes, even when the field is renamed.
"fld_01J9ZQ3F8X5W2K7M4N6P0R1S2T"
Display name. Safe to change.
Key used in record data. Part of the API contract.
Every record must have a value. Not available for boolean fields (a boolean is true or false; no value reads as false).
A list of distinct values (a repeated value is refused with duplicate_value, an empty string with blank_value). Not available for boolean, long_text, rich_text and json fields.
Where the field sorts in the collection's order, lowest first. New fields are added last; PUT /v1/collections/{collection_id}/field-order changes the order, numbering the fields from 0.
When the field was deleted; null unless it is. Its values stay hidden in records until it is restored or purged.
When a deleted field and its values are removed for good, unless restored first.
Old keys of a renamed field that still work until expires_at:
record data also carries the value under them, and writes, filters,
sorts and expand accept them. Responses about the collection then
have Deprecation and Sunset headers.
Show child attributes
Show child attributes
ISO 8601 timestamp in UTC.
"2026-09-27T12:00:00.000Z"
ISO 8601 timestamp in UTC.
"2026-09-27T12:00:00.000Z"
Plain text up to 10,000 characters, or a format.
Show child attributes
Show child attributes