Retrieve an assignment

{
  "entry": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/entry/AbCdEfGh",
    "title": "Project title"
  },
  "category": {
    "slug": "WxYzAbCd",
    "link": "https://api.au.cr4ce.com/category/WxYzAbCd",
    "name": {
      "en_GB": "Documentary"
    }
  },
  "chapter": {
    "slug": "MnOpQrSt",
    "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
    "name": {
      "en_GB": "Film"
    }
  },
  "comments": {
    "judging": [],
    "abstention": [],
    "conflict": [],
    "criteria": [
      {
        "name": "Originality",
        "comments": []
      },
      {
        "name": "Execution",
        "comments": []
      }
    ]
  },
  "created": "2025-01-15T09:00:00Z",
  "form": "GhIjKlMn",
  "method": "Automatic (Panel)",
  "panels": [
    {
      "slug": "OpQrStUv",
      "link": "https://api.au.cr4ce.com/panel/OpQrStUv",
      "name": {
        "en_GB": "Panel A"
      }
    }
  ],
  "judge": {
    "slug": "EfGhIjKl",
    "link": "https://api.au.cr4ce.com/judge/EfGhIjKl",
    "name": "Jane Doe"
  },
  "role": null,
  "rounds": [
    {
      "slug": "QrStUvWx",
      "link": "https://api.au.cr4ce.com/round/QrStUvWx",
      "name": {
        "en_GB": "Judging"
      }
    }
  ],
  "score": null,
  "score_set": {
    "slug": "UvWxYzAb",
    "link": "https://api.au.cr4ce.com/score-set/UvWxYzAb",
    "name": {
      "en_GB": "Scoring rubric"
    }
  },
  "slug": "AbCdEfGhEfGhIjKlUvWxYzAbA",
  "status": "To be scored",
  "updated": "2025-06-20T14:30:00Z"
}

{
  "message": "<string>",
  "status_code": 400
}

{
  "message": "<string>",
  "status_code": 401
}

{
  "message": "<string>",
  "status_code": 403
}

{
  "message": "<string>",
  "status_code": 429
}

{
  "status": "Maintenance in progress"
}

GET

assignment

{assignment_slug}

{
  "entry": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/entry/AbCdEfGh",
    "title": "Project title"
  },
  "category": {
    "slug": "WxYzAbCd",
    "link": "https://api.au.cr4ce.com/category/WxYzAbCd",
    "name": {
      "en_GB": "Documentary"
    }
  },
  "chapter": {
    "slug": "MnOpQrSt",
    "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
    "name": {
      "en_GB": "Film"
    }
  },
  "comments": {
    "judging": [],
    "abstention": [],
    "conflict": [],
    "criteria": [
      {
        "name": "Originality",
        "comments": []
      },
      {
        "name": "Execution",
        "comments": []
      }
    ]
  },
  "created": "2025-01-15T09:00:00Z",
  "form": "GhIjKlMn",
  "method": "Automatic (Panel)",
  "panels": [
    {
      "slug": "OpQrStUv",
      "link": "https://api.au.cr4ce.com/panel/OpQrStUv",
      "name": {
        "en_GB": "Panel A"
      }
    }
  ],
  "judge": {
    "slug": "EfGhIjKl",
    "link": "https://api.au.cr4ce.com/judge/EfGhIjKl",
    "name": "Jane Doe"
  },
  "role": null,
  "rounds": [
    {
      "slug": "QrStUvWx",
      "link": "https://api.au.cr4ce.com/round/QrStUvWx",
      "name": {
        "en_GB": "Judging"
      }
    }
  ],
  "score": null,
  "score_set": {
    "slug": "UvWxYzAb",
    "link": "https://api.au.cr4ce.com/score-set/UvWxYzAb",
    "name": {
      "en_GB": "Scoring rubric"
    }
  },
  "slug": "AbCdEfGhEfGhIjKlUvWxYzAbA",
  "status": "To be scored",
  "updated": "2025-06-20T14:30:00Z"
}

{
  "message": "<string>",
  "status_code": 400
}

{
  "message": "<string>",
  "status_code": 401
}

{
  "message": "<string>",
  "status_code": 403
}

{
  "message": "<string>",
  "status_code": 429
}

{
  "status": "Maintenance in progress"
}

Authorizations

x-api-key

string

header

required

API key used to authenticate and authorise every request. Include it in the x-api-key header.

Headers

enum<string>

required

Defines the response type.

Available options:

application/vnd.Creative Force.v2.3+json,

application/vnd.Creative Force.v2.3+xml

x-api-language

enum<string>[]

Defines the languages included in the response. If non are provided, the account default language is returned.

Value all overrides any other values present.

You can request multiple languages using a comma-separated string of languages.

The selected language must be supported by your account or a 400 error is returned.

Available options:

all,

ar_AR,

bg_BG,

bn_IN,

ca_ES,

cs_CZ,

cy_GB,

da_DK,

de_DE,

en_GB,

en_US,

el_GR,

es_NN,

es_LA,

et_EE,

fa_NN,

fi_FI,

fr_FR,

fr_CA,

he_IL,

hi_IN,

hr_HR,

hu_HU,

hy_AM,

it_IT,

ja_JP,

ko_KR,

lt_LT,

ms_MY,

nl_NL,

nb_NO,

pl_PL,

pt_BR,

ro_RO,

ru_RU,

sk_SK,

sl_SI,

sq_AL,

sr_RS,

sv_SE,

sw_NN,

th_TH,

tr_TR,

uk_UA,

vi_VN,

zh_CN,

zh_HK

Path Parameters

assignment_slug

string

required

Slug of the assignment.

Pattern: ^[A-Za-z0-9]{24}[JR]$

Response

Assignment retrieved.

Single judging task for an entry, addressed to either a judge or a role within a given round and score set.

Created automatically by panel allocation rules or manually by a panel manager. Lifecycle is tracked in status; the judging outcome lives in score.

Exactly one of judge and role is populated.

entry

object

Entry the assignment refers to.

Show child attributes

category

object

Category the entry belongs to.

Show child attributes

chapter

object

Chapter the category belongs to.

Show child attributes

comments

object | null

Comments attached to the assignment.

null for role-based assignments (where role is populated and judge is absent), since role holders do not own per-assignment comment threads.

Show child attributes

created

string<date-time>

Time the assignment was created.

form

string

Slug of the form attached to the entry.

method

string

How the assignment was created.

Known values include Manual, Automatic (Panel), Recused, and Stray. Other values are possible depending on the score-set mode.

panels

object[]

Panels the assignment is associated with.

Show child attributes

judge

object | null

Judge assigned to score the entry.

null for role-based assignments where role is populated instead.

Show child attributes

role

object | null

Role assigned to score the entry, used when the assignment is shared across all holders of a role rather than addressed to one judge.

null for judge-specific assignments where judge is populated.

Show child attributes

rounds

object[]

Rounds the assignment applies to.

Show child attributes

score

object | null

Score for this assignment, formatted per the score-set mode. null when no score has been recorded.

Shape varies by score-set mode. Two confirmed shapes:

Regular numeric or qualifying mode:

{
  "criteria": [
    {
      "name": { "en_GB": "Originality" },
      "value": 7,
      "max_score": 10,
      "final_score": "7/10",
      "weight": 1
    }
  ],
  "total_score": {
    "value": 7,
    "max_score": 10,
    "final_score": "7/10"
  }
}

Voting mode:

{ "total_votes": 0 }

VIP and top-pick modes follow their own conventions.

score_set

object | null

Score set used to evaluate the entry.

Show child attributes

slug

string

Short URL-safe identifier for the assignment.

status

string

Current state of the assignment.

Known values include To be scored, In progress, and Complete.

updated

string<date-time>

Time the assignment was last updated.

Create an assignment Delete an assignment

Account

Assignments

Attachments

Categories

Chapters

Contributors

Documents

Entries

Entries (realtime)

Fields

Files

Leaderboard

Orders

Review tasks

Rounds

Score sets

Seasons

Taxes

Users

Webhooks

Retrieve an assignment

Authorizations

Headers

Path Parameters

Response