Entries

Retrieve entries

Retrieves entries.

get/entry

Query parameters

entrantstring

Filter by entrant slug.

moderation'approved' | 'undecided' | 'rejected'

Filter by moderation status.

payment_status'paid' | 'awaiting_payment'

Filter by payment status.

pricestring

Filter by price slug.

review_statusstring

Filter by review status.

status'submitted' | 'in_progress' | 'resubmission_required' | 'resubmitted'

Filter by entry status.

titlestring

Filter by full or partial entry name.

updated_atstring

Filter by update timestamp. Supported values:

  • [before]=YYYY-MM-DDTHH:MM:SSZ
  • [after]=YYYY-MM-DDTHH:MM:SSZ
  • [on]=YYYY-MM-DDTHH:MM:SSZ
  • [between]=[YYYY-MM-DDTHH:MM:SSZ,YYYY-MM-DDTHH:MM:SSZ]
categorystring

Filter by category slug.

chapterstring

Filter by chapter slug.

formstring

Filter by form slug.

Use the value all to include results from every form rather than a single form.

seasonstring

Filter by season slug. Use all to show all seasons.

tagstring

Filter by tag.

archived'only' | 'all' | 'none'

Filter by archive mode.

  • only - Show only archived resources.
  • all - Include archived resources.
  • none - Exclude archived resources.
deleted'only' | 'included' | 'none'

Filter by deletion mode.

  • only - Show only deleted resources.
  • included - Include deleted resources.
  • none - Exclude deleted resources.
pagestring

Specify the page number to return.

per_pagestring

Limit the number of items returned to between 1 and 100.

order'category' | 'chapter' | 'entrant' | 'local_id' | 'parent_category' | 'title' | 'updated'

Sort by a supported entry field.

dir'asc' | 'desc'

Sort in ascending or descending order.

Headers

Accept'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml' required

Defines the response type.

x-api-languagestring[]

Defines the languages included in the response. If omitted, the account default language is used.

Value all overrides any other values present.

Response

Entries retrieved.

current_pageinteger

Number of the page returned by this response. The first page is 1.

first_page_urlstring uri

URL of the first page in the result set.

frominteger

Position of the first record on this page within the full result set. The first record is at position 1.

last_pageinteger

Number of the last page. Equals the total number of pages.

last_page_urlstring uri

URL of the last page in the result set.

next_page_urlstring

URL of the next page in the result set.

Empty string when the current page is the last page.

pathstring uri

Canonical URL of the endpoint, without query parameters.

per_pageinteger

Maximum number of records returned per page.

prev_page_urlstring

URL of the previous page in the result set.

Empty string when the current page is the first page.

tointeger

Position of the last record on this page within the full result set.

totalinteger

Total number of records across all pages.

Example response

{
  "current_page": 1,
  "data": [
    {
      "entrant": {
        "slug": "AbCdEfGh",
        "link": "https://api.au.cr4ce.com/user/AbCdEfGh",
        "name": "Ada Lovelace",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "email": "ada.lovelace@example.com",
        "global_id": "9c78dcbc-53cf-42f1-b5b3-82fe396f66e6"
      },
      "auto_score": 0,
      "category": {
        "slug": "EfGhIjKl",
        "link": "https://api.au.cr4ce.com/category/EfGhIjKl",
        "name": {
          "en_GB": "Short film"
        }
      },
      "chapter": {
        "slug": "MnOpQrSt",
        "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
        "name": {
          "en_GB": "Europe"
        }
      },
      "comments": "Jordan Lee (2025-06-03T10:45:29+00:00): manager comment",
      "contributor_count": 1,
      "created": "2025-03-11T15:00:03Z",
      "custom_deadline": "-",
      "division": 2,
      "eligibility_status": "",
      "files_count": 1,
      "form": {
        "slug": "StUvWxYz",
        "link": "https://api.au.cr4ce.com/form/StUvWxYz",
        "name": {
          "en_GB": "Entry form"
        }
      },
      "grant_end_date": null,
      "grant_status": null,
      "local_id": 916,
      "moderation_status": "undecided",
      "parent_category": null,
      "payment_status": "Paid",
      "plagiarism_scan_status": "unscanned",
      "review_status": "",
      "season": {
        "slug": "BcDeFgHi",
        "link": "https://api.au.cr4ce.com/season/BcDeFgHi",
        "name": {
          "en_GB": "2026"
        }
      },
      "slug": "PqRsTuVw",
      "status": "submitted",
      "submitted": "2025-08-11T13:19:42Z",
      "tags": "documentary, finalist",
      "title": "Documentary series",
      "updated": "2026-06-18T07:25:20Z",
      "user_comments": "Jordan Lee (2025-02-19T14:22:43+00:00): strong submission"
    },
    {
      "entrant": {
        "slug": "IjKlMnOp",
        "link": "https://api.au.cr4ce.com/user/IjKlMnOp",
        "name": "Alan Turing",
        "first_name": "Alan",
        "last_name": "Turing",
        "email": "alan.turing@example.com",
        "global_id": "2f4c9b1a-7d6e-4c3b-9a2f-1e8d5c7b6a40"
      },
      "auto_score": 0,
      "category": {
        "slug": "EfGhIjKl",
        "link": "https://api.au.cr4ce.com/category/EfGhIjKl",
        "name": {
          "en_GB": "Short film"
        }
      },
      "chapter": {
        "slug": "MnOpQrSt",
        "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
        "name": {
          "en_GB": "Europe"
        }
      },
      "comments": "",
      "contributor_count": 0,
      "created": "2025-04-02T09:12:00Z",
      "custom_deadline": "-",
      "division": null,
      "eligibility_status": "",
      "files_count": 0,
      "form": {
        "slug": "StUvWxYz",
        "link": "https://api.au.cr4ce.com/form/StUvWxYz",
        "name": {
          "en_GB": "Entry form"
        }
      },
      "grant_end_date": null,
      "grant_status": null,
      "local_id": 917,
      "moderation_status": "undecided",
      "parent_category": null,
      "payment_status": "Unpaid",
      "plagiarism_scan_status": "unscanned",
      "review_status": "",
      "season": {
        "slug": "BcDeFgHi",
        "link": "https://api.au.cr4ce.com/season/BcDeFgHi",
        "name": {
          "en_GB": "2026"
        }
      },
      "slug": "YzAbCdEf",
      "status": "in_progress",
      "submitted": null,
      "tags": "",
      "title": "Working title",
      "updated": "2025-04-02T09:12:00Z",
      "user_comments": ""
    }
  ]
}

Changes