---
title: "Retrieve entries"
method: GET
path: "/entry"
tags: ["Entries"]
---

# Retrieve entries

`GET /entry`

Retrieves entries.

## Query parameters

- `entrant` string
- `moderation` 'approved' | 'undecided' | 'rejected'
- `payment_status` 'paid' | 'awaiting_payment'
- `price` string
- `review_status` string
- `status` 'submitted' | 'in_progress' | 'resubmission_required' | 'resubmitted'
- `title` string
- `updated_at` string
- `category` string
- `chapter` string
- `form` string
- `season` string
- `tag` string
- `archived` 'only' | 'all' | 'none'
- `deleted` 'only' | 'included' | 'none'
- `page` number
- `per_page` number
- `order` 'category' | 'chapter' | 'entrant' | 'local_id' | 'parent_category' | 'title' | 'updated'
- `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`

Entries retrieved.

- EntryList — 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` EntrySummary[] — Entries on the current page.
    - `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.

## 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 `Entries` added
  - api tag `Entry` removed
- **2026-07-04** (v2) `d62618a953f9` — 1 breaking, 1 info
  - removed the enum value `applicant` from the `query` request parameter `order`
  - added the new enum value `entrant` to the `query` request parameter `order`
- …earlier changes not shown

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