Skip to main content
GET
Get task summary

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
task_uuid
string
required

Annotation task to act on

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Query Parameters

​
item_id
string | null

Filter rows to a single item. The full task-wide annotator union is still returned in annotators

​
live_only
boolean
default:false

When true, emit only one row for each (item, evaluator) pair using the evaluator's live version. Versions other than the live one that have runs are excluded

​
disagreement_only
boolean
default:false

When true, keep only rows where the evaluator disagreed with at least one annotator

​
q
string | null

Case-insensitive substring search on payload.name. Blank is a no-op

​
sort_by
string
default:created_at

Sort key for the results

​
order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
limit
integer
default:50

Maximum number of items to return

Required range: 1 <= x <= 1000000
​
offset
integer
default:0

Number of items to skip before returning results

Required range: x >= 0
​
compact
boolean
default:false

Return a compact response that omits heavy detail fields (rows.payload, rows.evaluator_reasoning, rows.annotations.reasoning, evaluators.versions.system_prompt, evaluators.versions.output_config, evaluators.versions.variables, item_comments), keeping only the lightweight decision fields. Omit for full detail

Response

Successful Response

​
task_id
string
required

ID of the task

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

​
task_type
enum<string>
required

Type of the task

Available options:
stt,
llm,
llm-general,
conversation,
tts
​
evaluators
object[]
required

The task's evaluators, stable across pages, each with its live rubric

​
annotators
object[]
required

The annotators who labelled or commented on items in the task, stable across pages

​
rows
object[]
required

One row per item, evaluator, and version on this page, with the evaluator's value and each annotator's label

​
pagination
PaginationMeta · object
required

Where this page sits in the full item list

​
item_comments
object | null

Annotator comments, keyed by item ID