Skip to main content
POST
/
v1
/
runs
/
batch
Get multiple runs by IDs
curl --request POST \
  --url https://agent.tinyfish.ai/v1/runs/batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "run_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012"
  ]
}
'
{
  "data": [
    {
      "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "COMPLETED",
      "goal": "Find all pricing information",
      "created_at": "2024-01-01T00:00:00Z",
      "started_at": "2024-01-01T00:00:05Z",
      "finished_at": "2024-01-01T00:00:30Z",
      "result": {
        "product": "iPhone 15",
        "price": "$799"
      },
      "error": null
    }
  ],
  "not_found": [
    "b2c3d4e5-f6a7-8901-bcde-f23456789012"
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Body

application/json

Array of run IDs to fetch

Batch runs request

​
run_ids
string[]
required

Array of run IDs (1-100)

Required array length: 1 - 100 elements
Example:
[
  "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "b2c3d4e5-f6a7-8901-bcde-f23456789012"
]

Response

Request succeeded. Returns found runs in data and any missing IDs in not_found.

Batch get runs response

​
data
object[]
required

Found runs

​
not_found
string[] | null
required

Run IDs that were not found or not owned. Null if all found.