Skip to main content
GET
/
v2
/
datasets
/
deliveries
API_KEY='live_...'
curl --request GET \
    --url "https://api.scale.com/v2/datasets/deliveries" \
    --header "Authorization: Bearer $API_KEY"
{
  "deliveries": [
    {
      "id": "delivery_abc123",
      "name": "My Delivery - 2024-01-15",
      "delivered_at": "2024-01-15T10:30:00Z",
      "metadata": {
        "task_count": 100,
        "turn_count": 100
      },
      "dataset": "dataset_abc123"
    },
    {
      "id": "delivery_def456",
      "name": "My Delivery - 2024-01-16",
      "delivered_at": "2024-01-16T10:30:00Z",
      "metadata": {
        "task_count": 100,
        "turn_count": 100
      },
      "dataset": "dataset_def456"
    }
  ]
}
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.

​
Required query parameters

You are expected to provide the following to find deliveries:
  • dataset_id - The ID of the Scale dataset.

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

​
dataset_id
string

Scale's unique identifier for the dataset. Unique identifier for a dataset

Example:

"dataset_abc123"

​
delivered_after
string<date-time>

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

​
delivered_before
string<date-time>

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

​
expand
enum<string>[]

List of fields to expand in the response. Entities that can be expanded from an ID to an object.

Entities that can be expanded from an ID to an object.

Available options:
dataset

Response

List of deliveries.

​
deliveries
object[]
required