GET
/
evaluations
List evaluation jobs
curl --request GET \
  --url https://api.together.xyz/v1/evaluations \
  --header 'Authorization: Bearer <token>'
[
  {
    "workflow_id": "eval-1234aedf",
    "type": "classify",
    "owner_id": "<string>",
    "status": "completed",
    "status_updates": [
      {
        "status": "pending",
        "message": "Job is pending evaluation",
        "timestamp": "2025-07-23T17:10:04.837888Z"
      }
    ],
    "parameters": {},
    "created_at": "2025-07-23T17:10:04.837888Z",
    "updated_at": "2025-07-23T17:10:04.837888Z",
    "results": {
      "generation_fail_count": 0,
      "judge_fail_count": 0,
      "invalid_label_count": 0,
      "result_file_id": "file-1234-aefd",
      "pass_percentage": 10,
      "label_counts": "{\"yes\": 10, \"no\": 0}"
    }
  }
]

Authorizations

​
Authorization
string
header
default:default
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
status
enum<string>

Filter by job status

Available options:
pending,
queued,
running,
completed,
error,
user_error
​
limit
integer
default:10

Maximum number of results to return (max 100)

Required range: 1 <= x <= 100

Response

200
application/json

Successful response

The response is of type object[].