Retrieve an assignment

{
  "application": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/application/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"
      }
    }
  ],
  "reviewer": {
    "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}

{
  "application": {
    "slug": "AbCdEfGh",
    "link": "https://api.au.cr4ce.com/application/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"
      }
    }
  ],
  "reviewer": {
    "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 scoring task for an application, addressed to either a reviewer 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 scoring outcome lives in score.

Exactly one of reviewer and role is populated.

application

object

Application the assignment refers to.

Show child attributes

category

object

Category the application 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 reviewer 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 application.

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

reviewer

object | null

Reviewer assigned to score the application.

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

Show child attributes

role

object | null

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

null for reviewer-specific assignments where reviewer 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 application.

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

Action tasks

Allocation payments

Allocations

Applications

Applications (realtime)

Assignments

Attachments

Categories

Chapters

Contributors

Documents

Fields

Files

Forms

Funds

Grant statuses

Leaderboard

Rounds

Score sets

Seasons

Taxes

Users

Webhooks

Grant reports

Retrieve an assignment

Authorizations

Headers

Path Parameters

Response