TEtectonic
Assignments

Retrieve an assignment

Changed on

Retrieves the assignment identified by the specified slug.

get/assignment/{assignment_slug}

Request

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 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.

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

  • v2b8c0209c985aRevision changes
    • breaking

      the response property became nullable for the status (media type: application/json)

    • breaking

      the response property became nullable for the status (media type: application/xml)

  • v272c39d7099a2Revision changes
    • breaking

      the response property became nullable for the status (media type: application/json)

    • breaking

      the response property became nullable for the status (media type: application/xml)