---
title: "Retrieve fields"
method: GET
path: "/field"
tags: ["Fields"]
---

# Retrieve fields

`GET /field`

Retrieves fields.

## Query parameters

- `conditional` string
- `protection` 'standard' | 'elevated' | 'maximum'
- `resource` 'entries' | 'users' | 'attachments' | 'contributors'
- `type` 'checkbox' | 'checkboxlist' | 'content' | 'country' | 'currency' | 'date' | 'datetime' | 'drop-down-list' | 'email' | 'file' | 'numeric' | 'phone' | 'radio' | 'table' | 'text' | 'textarea' | 'time' | 'url'
- `category` string
- `form` string
- `tab` string
- `season` string
- `deleted` 'only' | 'included' | 'none'
- `page` number
- `per_page` number
- `order` 'title' | 'resource' | 'type' | 'updated' | 'created' | 'categories' | 'order' | 'tab' | 'form' | 'auto_scoring' | 'category_count'
- `dir` 'asc' | 'desc'

## Headers

- `Accept` 'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml', required
- `x-api-language` string[]

## Response `200`

Fields retrieved.

- FieldList — Pagination envelope returned by every list endpoint. Wraps the result set with positional fields (`current_page`, `from`, `to`, `total`) and navigation URLs (`first_page_url`, `last_page_url`, `next_page_url`, `prev_page_url`) for traversing the full list. The records themselves are returned in a sibling `data` array supplied by the wrapping schema.
  - `current_page` integer — Number of the page returned by this response. The first page is `1`.
  - `first_page_url` string — URL of the first page in the result set. Relative when the requested page is beyond the last page.
  - `from` integer, nullable — Position of the first record on this page within the full result set. The first record is at position `1`. `null` when the requested page is beyond the last page.
  - `last_page` integer — Number of the last page. Equals the total number of pages.
  - `last_page_url` string — URL of the last page in the result set. Relative when the requested page is beyond the last page.
  - `next_page_url` string — URL of the next page in the result set. Empty string when the current page is the last page.
  - `path` string — Canonical URL of the endpoint, without query parameters.
  - `per_page` integer — Maximum number of records returned per page.
  - `prev_page_url` string — URL of the previous page in the result set. Empty string when the current page is the first page.
  - `to` integer, nullable — Position of the last record on this page within the full result set. `null` when the requested page is beyond the last page.
  - `total` integer — Total number of records across all pages.
  - `data` Field[]
    - `entrant_read_access` boolean — Whether entrants can view this field.
    - `entrant_write_access` boolean — Whether entrants can edit this field.
    - `auto_scoring` integer — Score awarded automatically for the field, or `0` when automatic judging is not configured.
    - `categories` string[] — Category slugs the field is associated with. The single-element array `["*"]` indicates the field applies to every category.
    - `category_count` unknown
    - `conditional_field` object, nullable — Field whose value controls whether this field is shown, or `null` when the field is not conditional.
      - `slug` string — Short URL-safe identifier for the controlling field.
      - `link` string, uri — Canonical URL for the controlling field resource.
      - `name` object — Display name of the controlling field. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `created` string, date-time — Date and time when the field was created.
    - `file_types` string[] — Permitted file extensions for file fields. Empty when the field does not accept file uploads or no restriction applies.
    - `form` object, nullable — Form the field belongs to, or `null` when the field is not attached to a form.
      - `slug` string — Short URL-safe identifier for the form.
      - `link` string, uri — Canonical URL for the form resource.
      - `name` object — Display name of the form. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `help_text` object — Help text shown for the field, as an HTML fragment. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `hint_text` object — Hint text shown for the field, as an HTML fragment. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `label` object — Label of the field, as an HTML fragment. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `max_file_size` integer, nullable — Maximum upload size in megabytes for file fields, or `null` when no limit applies.
    - `maximum_characters` integer, nullable — Maximum number of characters accepted, or `null` when no limit applies.
    - `maximum_words` integer, nullable — Maximum number of words accepted, or `null` when no limit applies.
    - `minimum_characters` integer, nullable — Minimum number of characters required, or `null` when no limit applies.
    - `minimum_words` integer, nullable — Minimum number of words required, or `null` when no limit applies.
    - `options` string[] — Selectable options for choice fields (for example, drop-down or radio). Empty when the field type has no options.
    - `order` integer — Position of the field within its tab, used for ordering.
    - `protection` string — Protection level governing access to the data for the field (for example, `standard`, `elevated`, or `maximum`).
    - `registration` string, nullable — Registration attribute the field is mapped to, or `null` when the field is not mapped to a registration attribute.
    - `required` boolean — Whether a value is required for the field.
    - `resource` string — Resource the field collects data for (for example, the entry or application, `contributors`, `referees`, `attachments`, or `users`).
    - `searchable` boolean — Whether the field is included in search.
    - `season` object — Season the field belongs to.
      - `slug` string — Short URL-safe identifier for the season.
      - `link` string, uri — Canonical URL for the season resource.
      - `name` object — Display name of the season. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `slug` string — Short URL-safe identifier for the field.
    - `tab` object, nullable — Tab the field belongs to, or `null` when the field is not attached to a tab.
      - `slug` string — Short URL-safe identifier for the tab.
      - `link` string, uri — Canonical URL for the tab resource.
      - `name` object — Display name of the tab. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `title` object — Plain-text title of the field. Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
    - `type` string — Field type (for example, `text`, `textarea`, `drop-down-list`, `file`, `currency`, or `date`).
    - `updated` string, date-time — Date and time when the field was last updated.
    - `visibility` string[] — Contexts in which the field is visible (for example, `qualifying`, `top_pick`, `voting`, `gallery`, or `vip_judging`).

## Other responses

- `400` — Request was rejected before the endpoint could process it. Common causes: invalid `Accept` header, unsupported `x-api-language` code, empty request body on `POST` / `PUT`, invalid JSON in the request body, or an invalid slug format in a path parameter.
- `401` — Missing `x-api-key` header.
- `403` — Authenticated request denied. Common causes: invalid or unknown API key, suspended account, or `api` feature not enabled for the account.
- `429` — Rate limit of 60 requests per minute exceeded.
- `503` — Service is temporarily unavailable due to regional maintenance.

## Changes

- **2026-07-13** (v2) `e2511e46f9f2` — 2 breaking, 2 info
  - for the `query` request parameter `page`, the type/format was changed from `string`/`` to `number`/``
  - for the `query` request parameter `per_page`, the type/format was changed from `string`/`` to `number`/``
  - the `per_page` response's property default value `10` was added for the status `200` (media type: application/json)
  - the `per_page` response's property default value `10` was added for the status `200` (media type: application/xml)
- **2026-07-08** (v2) `a269ebb35abf` — 10 breaking
  - the response property `allOf[subschema #1: Pagination]/from` became nullable for the status `200` (media type: application/json)
  - the response property `allOf[subschema #1: Pagination]/from` became nullable for the status `200` (media type: application/xml)
  - the response property `allOf[subschema #1: Pagination]/to` became nullable for the status `200` (media type: application/json)
  - the response property `allOf[subschema #1: Pagination]/to` became nullable for the status `200` (media type: application/xml)
  - …6 more
- **2026-07-07** (v2) `9b9103538ceb` — 2 info
  - api tag `Fields` added
  - api tag `Field` removed
- …earlier changes not shown

[Full history](https://skmtc.dev/tectonic/apis/award-force-api/changes/field/get.md)

---

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