---
title: "Retrieve a form"
method: GET
path: "/form/{form_slug}"
tags: ["Form"]
---

# Retrieve a form

`GET /form/{form_slug}`

Retrieves the form identified by the specified slug.

## Path parameters

- `form_slug` string, required

## Headers

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

## Response `200`

Form retrieved.

- Form — Form used to collect entries within a season. Carries the translated name and call to action, the season it belongs to, its type, and its chapter and content-block settings.
  - `callToAction` object — Call to action 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.
  - `chapter_option` 'all' | 'select' — How chapters are applied to the form. * `all` - Available to every chapter. * `select` - Available to selected chapters only.
  - `content_block` object, nullable — Content block displayed with the form. `null` when no content block is assigned.
    - `slug` string — URL-safe identifier of the content block.
    - `link` string, uri — Canonical URL for the content block resource.
    - `name` object — Translated name of the content block, keyed by locale code.
  - `created` string, date-time — Date and time when the form was created.
  - `name` object — 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.
  - `season` object, nullable — Season the form belongs to. `null` when the form is not assigned to a season.
    - `slug` string — URL-safe identifier of the season.
    - `link` string, uri — Canonical URL for the season resource.
    - `name` object — Translated name of the season, keyed by locale code.
  - `slug` string — URL-safe identifier of the form.
  - `type` 'entry' | 'report' — Type of the form. * `entry` - Collects entries. * `report` - Collects grant reports.
  - `updated` string, date-time — Date and time when the form was last updated.

## 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.
- `404` — Resource identified by the path slug does not exist. Returned when the slug is well-formed but no record matches it.
- `429` — Rate limit of 60 requests per minute exceeded.
- `503` — Service is temporarily unavailable due to regional maintenance.

## Changes

- **2026-07-01** (v2) `e96a96d4507e` — 7 info
  - added the media type `application/xml` for the response with the status `200`
  - added the media type `application/xml` for the response with the status `400`
  - added the media type `application/xml` for the response with the status `401`
  - added the media type `application/xml` for the response with the status `403`
  - …3 more
- **2026-06-30** (v2) `110cec4c3d56` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tectonic/apis/award-force-api/changes/form/:form_slug/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/e96a96d4507e/schema)