---
title: "Retrieve an entry"
method: GET
path: "/entry/{entry_slug}"
tags: ["Entries"]
---

# Retrieve an entry

`GET /entry/{entry_slug}`

Retrieves the entry identified by the specified slug.

## Headers

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

## Response `200`

Entry retrieved.

- Entry — Detailed entry collections returned only for a single entry.
  - `entrant` object — Entrant who created and owns the entry.
    - `slug` string — URL-safe identifier of the entrant.
    - `link` string, uri — URL of the entrant resource.
    - `name` string — Full name of the entrant.
    - `first_name` string — First name of the entrant.
    - `last_name` string — Last name of the entrant.
    - `email` string, email — Email address of the entrant.
    - `global_id` string — Globally unique identifier of the entrant.
  - `auto_score` integer — Automated score calculated for the entry.
  - `category` object — Category the entry is assigned to.
    - `slug` string — URL-safe identifier of the category.
    - `link` string, uri — URL of the category resource.
    - `name` object — Name of the category. 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` object — Chapter the entry is assigned to.
    - `slug` string — URL-safe identifier of the chapter.
    - `link` string, uri — URL of the chapter resource.
    - `name` object — Name of the chapter. 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.
  - `comments` string — Manager comments recorded on the entry, joined into a single string.
  - `contributor_count` integer — Number of contributors linked to the entry.
  - `created` string, date-time — Date and time when the entry was created.
  - `custom_deadline` string — Custom submission deadline for the entry, or `-` when none is set.
  - `division` integer, nullable — Division number assigned to the entry, or `null` when none is assigned.
  - `eligibility_status` string — Eligibility status of the entry.
  - `files_count` integer — Number of files uploaded to the entry.
  - `form` object — Entry form used to capture the entry.
    - `slug` string — URL-safe identifier of the form.
    - `link` string, uri — URL of the form resource.
    - `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.
  - `grant_end_date` string, nullable — Date when the grant ends, or `null` when not applicable.
  - `grant_status` object, nullable — Grant status assigned to the entry, or `null` when none is set.
    - `slug` string — URL-safe identifier of the grant status.
    - `link` string, uri — URL of the grant status resource.
    - `name` object — Name of the grant status. 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.
  - `local_id` integer — Sequential identifier of the entry within the account.
  - `moderation_status` string — Moderation status of the entry.
  - `parent_category` object, nullable — Parent of the assigned category, or `null` when the category has no parent.
    - `slug` string — URL-safe identifier of the parent category.
    - `link` string, uri — URL of the parent category resource.
    - `name` object — Name of the parent category. 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.
  - `payment_status` string — Payment status of the entry.
  - `plagiarism_scan_status` string — Plagiarism scan status of the entry.
  - `review_status` string — Review status of the entry.
  - `season` object — Season the entry belongs to.
    - `slug` string — URL-safe identifier of the season.
    - `link` string, uri — URL of the season resource.
    - `name` object — 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 — URL-safe identifier of the entry.
  - `status` string — Submission status of the entry. Possible values include `submitted`, `in_progress`, `resubmission_required`, `resubmitted`, `invited`, and `not_approved_for_submission`.
  - `submitted` string, date-time, nullable — Date and time when the entry was submitted, or `null` when not yet submitted.
  - `tags` string — Tags applied to the entry, as a comma-separated list.
  - `title` string — Title of the entry.
  - `updated` string, date-time — Date and time when the entry was last updated.
  - `user_comments` string — Comments left by users on the entry, joined into a single string.
  - `entry_fields` object[] — Form field responses captured on the entry.
    - `slug` string — URL-safe identifier of the field.
    - `link` string, uri — URL of the field resource.
    - `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.
    - `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.
    - `value` unknown
    - `token` string — File token for the uploaded file, present on file fields.
    - `dynamicRows` unknown[] — Rows captured for a table field.
      - unknown
    - `values` object — Cell values for a table field, keyed by cell reference.
    - `translated` object — Translated value submitted for 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.
    - `download` string, uri — Temporary download URL for the uploaded file, present on file fields.
  - `attachments` object[] — Files attached to the entry.
    - `token` string — URL-safe identifier of the attachment.
    - `link` string, uri — URL of the attachment resource.
    - `file` object — File stored for the attachment.
      - `token` string — URL-safe identifier of the file.
      - `link` string, uri — URL of the file resource.
      - `filename` string — Original name of the uploaded file.
      - `download` string, uri — Temporary download URL for the file.
    - `attachment_fields` object[] — Field responses captured against the attachment.
      - `slug` string — URL-safe identifier of the field.
      - `link` string, uri — URL of the field resource.
      - `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.
      - `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.
      - `value` string — Value submitted for the field.
      - `translated` object — Translated value submitted for 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.
    - `tab` object — Form tab the attachment belongs to.
      - `slug` string — URL-safe identifier of the tab.
      - `type` string — Type of the tab.
      - `created_at` string, date-time — Date and time when the tab was created.
      - `updated_at` string, date-time — Date and time when the tab was last updated.
  - `contributors` object[] — Contributors linked to the entry.
    - `slug` string — URL-safe identifier of the contributor.
    - `tab` object — Form tab the contributor belongs to.
      - `slug` string — URL-safe identifier of the tab.
      - `type` string — Type of the tab.
      - `created_at` string, date-time — Date and time when the tab was created.
      - `updated_at` string, date-time — Date and time when the tab was last updated.
    - `contributor_fields` object[] — Field responses captured against the contributor.
      - `slug` string — URL-safe identifier of the field.
      - `link` string, uri — URL of the field resource.
      - `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.
      - `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.
      - `value` string — Value submitted for the field.
      - `translated` object — Translated value submitted for 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.

## 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-07** (v2) `9b9103538ceb` — 2 info
  - api tag `Entries` added
  - api tag `Entry` removed
- **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

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