Skip to main content
GET
Every request sent to Scale’s API requires authentication. In short, your API Key is the Bearer token. See the Authentication section for more details.
Remember to handle pagination when downloading large sets of tasks.
The API returns a maximum of 100 tasks per request (or less if you specify a limit). If your request returns more tasks than your specified limit, API response will also contain a next_token until you reach to the last page.You can set the next_token in your next request to continue downloading tasks from the next page.

Required query parameters

You must provide one of the following:
  • project_id or project_name - Get all delivered tasks from a project

Optional filters

  • delivery_id - Filter to tasks from a specific delivery
  • status - Filter by task status
  • completed_after, completed_before - Filter by completion time range

Overview

Returns delivered task responses from a project. For delivered tasks, includes:
  • Complete response data (threads, turns, messages, annotations, etc.)
  • Delivery timestamp and ID
  • Task metadata
Tasks without deliveries have null for delivery-related fields. Compared to /v2/delivery: Returns full task response content, not just task metadata.

Authorizations

Authorization
string
header
required

Your API Key is the Bearer token. See the Authentication section to learn how to access your key.

Query Parameters

delivery_id
string

Scale's unique identifier for the delivery. A unique identifier for the delivery.

Example:

"delivery_abc123"

project_id
string

Scale's unique identifier for the project. A unique identifier for the project.

Example:

"project_abc123"

project_name
string

The name of the project.

Example:

"My Scale Project"

status
enum<string>

The current status of the task, indicating whether it is pending, completed, error, or canceled.

Available options:
pending,
completed,
canceled,
error
completed_after
string<date-time>

A timestamp formatted as an ISO 8601 date-time string.

completed_before
string<date-time>

A timestamp formatted as an ISO 8601 date-time string.

limit
integer

Limit the number of entities returned.

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

A token used to retrieve the next page of results if there are more. You can find the next_token in your last request

Response

List of tasks with delivered responses.

docs
object[]
required
total
integer
required

Total number of tasks returned

next_token
string

Token for pagination to retrieve the next page of results