Sign in
Assignments

Retrieve an assignment

Retrieves the assignment identified by the specified slug.

get/assignment/{assignment_slug}

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

Assignment retrieved.

createdstring date-time

Time the assignment was created.

formstring

Slug of the form attached to the entry.

methodstring

How the assignment was created.

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

scoreobject nullable

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.

slugstring

Short URL-safe identifier for the assignment.

statusstring

Current state of the assignment.

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

updatedstring date-time

Time the assignment was last updated.

Example response

{
  "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"
}

Changes