Skip to main content
GET

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

Accept
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

Query Parameters

slug
string

Filter to a single assignment by slug. Returns at most one item.

Pattern: ^[A-Za-z0-9]{24}[JR]$
status
enum<string>

Filter by assignment status.

Available options:
none,
in_progress,
complete,
abstained
category
string

Filter by category slug.

chapter
string

Filter by chapter slug.

judge
string

Filter by judge slug.

method
enum<string>

Filter by assignment method.

Available options:
automatic,
manual,
random,
stray,
recused
panel
string

Filter by panel slug.

score_set
string

Filter by score set slug.

season
string

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

state
enum<string>

Filter by entry state.

  • current - Only current (non-archived) entries.
  • archived - Only archived entries.
  • all - Include both current and archived entries.
  • only - Equivalent to archived.
  • none - Exclude all entries.
Available options:
current,
archived,
all,
only,
none
tag
string

Filter by tag.

deleted
enum<string>

Filter by deletion mode.

  • only - Show only deleted resources.
  • included - Include deleted resources.
  • none - Exclude deleted resources.
Available options:
only,
included,
none
trashed
enum<string>

Filter by soft-deletion mode.

  • only - Show only soft-deleted resources.
  • all - Include soft-deleted resources alongside live ones.
  • none - Exclude soft-deleted resources.
Available options:
only,
all,
none
page
number

Specify the page number to return.

per_page
number

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

If you provide a value outside this range, you will receive a 400 response.

order
enum<string>

Sort by a supported assignment column. Unsupported values fall back silently to the default sort (updated descending).

Available options:
method,
status,
updated
dir
enum<string>

Sort in ascending or descending order. Invalid values are rejected with 400 Bad Request.

Available options:
asc,
desc

Response

Assignments retrieved.

Pagination envelope returned by every list endpoint.

Wraps the result set with positional fields (current_page, from, to, total) and navigation URLs (first_page_url, last_page_url, next_page_url, prev_page_url) for traversing the full list. The records themselves are returned in a sibling data array supplied by the wrapping schema.

current_page
integer

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

first_page_url
string

URL of the first page in the result set. Relative when the requested page is beyond the last page.

from
integer | null

Position of the first record on this page within the full result set. The first record is at position 1. null when the requested page is beyond the last page.

last_page
integer

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

last_page_url
string

URL of the last page in the result set. Relative when the requested page is beyond the last page.

next_page_url
string

URL of the next page in the result set.

Empty string when the current page is the last page.

path
string

Canonical URL of the endpoint, without query parameters.

per_page
integer
default:10

Maximum number of records returned per page.

Required range: 1 <= x <= 100
prev_page_url
string

URL of the previous page in the result set.

Empty string when the current page is the first page.

to
integer | null

Position of the last record on this page within the full result set. null when the requested page is beyond the last page.

total
integer

Total number of records across all pages.

data
Assignment · object[]