Skip to main content
GET
/
v2
/
task
API_KEY='live_...'
TASK_ID='abc123'
curl --request GET \
--url "https://api.scale.com/v2/task?task_id=$TASK_ID" \
--header "Authorization: Bearer $API_KEY"
{
"task_id": "task_123",
"project": "project_123",
"batch": "batch_123",
"status": "completed",
"created_at": "2025-01-01T08:31:03.169Z",
"completed_at": "2025-01-02T04:00:39.923Z",
"threads": [
{
"id": "thread_0",
"turns": [
{
"id": "turn_0",
"messages": [
{
"content": {
"text": "This is an example prompt"
},
"role": "user",
"source_id": "user",
"annotations": []
},
{
"content": {
"text": "This is the base model response"
},
"role": "assistant",
"source_id": "base_model",
"model_parameters": {
"model": "scale-gpt-1.5-turbo",
"temperature": 0.9,
"max_completion_tokens": 2048
},
"annotations": [
{
"key": "instruction_following",
"value": 3
},
{
"key": "truthfulness",
"value": 2
},
{
"key": "conciseness",
"value": 3
},
{
"key": "format",
"value": 3
},
{
"key": "safety",
"value": 3
},
{
"key": "overall",
"value": 5
}
]
},
{
"content": {
"text": "This is test model response"
},
"role": "assistant",
"source_id": "test_model",
"model_parameters": {
"model": "scale-gpt-2.0",
"temperature": 0.9,
"max_completion_tokens": 2048
},
"annotations": [
{
"key": "instruction_following",
"value": 2
},
{
"key": "truthfulness",
"value": 1
},
{
"key": "truthfulness_justification",
"value": "The response incorrectly classifies..."
},
{
"key": "conciseness",
"value": 2
},
{
"key": "format",
"value": 3
},
{
"key": "safety",
"value": 3
},
{
"key": "overall",
"value": 3
}
]
}
],
"annotations": [
{
"key": "selected_model_id",
"value": "base_model"
},
{
"key": "likert_value",
"value": 2
},
{
"key": "justification",
"value": "@Response 1 is better than @Response 2. @Response 2 has an issue in Truthfulness ..."
}
]
}
],
"annotations": []
}
]
}
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.

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

task_id
string
required

Scale's unique identifier for the task.

Example:

"task_abc123"

expand
enum<string>[]

List of fields to expand in the response.

opts
enum<string>[]

List of properties to include in the task response.

Response

Completed task.

task_id
string
required

Unique identifier for the task.

Example:

"task_abc123"

project
required

Project ID or Project associated with the task. A unique identifier for the project.

Example:

"project_abc123"

status
enum<string>
required

Current status of the task.

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

UTC timestamp when the task was created.

batch

Batch ID or Batch associated with the task. A unique identifier for the batch.

Example:

"batch_abc123"

completed_at
string<date-time>

UTC timestamp when the task was completed.

metadata
object

Custom metadata for the entity.

threads
object[]

Threads associated with the task. Tasks that do not have a status of completed will have an empty threads array.

errors
object[]

Errors associated with the task. Available when the task status is error

sensitive_content_reports
object[]

Reports of sensitive content within the task. Available when the task status is completed. threads will not exist when the task is reported.