Get runs

The Runs API endpoint allows you to retrieve data about specific runs from your Lunary application.

The most common run types are ‘llm’, ‘agent’, ‘chain’, ‘tool’, ‘thread’ and ‘chat’.

It supports various filters to narrow down the results according to your needs.

This endpoint supports GET requests and expects query parameters for filtering the results.

GET /v1/runs

Get runs

cURL

curl --request GET \
  --url https://api.lunary.ai/v1/runs \
  --header 'Authorization: Bearer <token>'

200

{
  "total": 200,
  "page": 1,
  "limit": 10,
  "data": [
    {
      "type": "llm",
      "name": "gpt-5",
      "createdAt": "2025-10-01T12:00:00Z",
      "endedAt": "2025-10-01T12:00:03Z",
      "duration": 3,
      "tokens": {
        "completion": 100,
        "prompt": 50,
        "total": 150
      },
      "feedback": null,
      "status": "success",
      "tags": [
        "example"
      ],
      "templateSlug": "example-template",
      "templateVersionId": 1234,
      "input": [
        {
          "role": "user",
          "content": "Hello world!"
        }
      ],
      "output": [
        {
          "role": "assistant",
          "content": "Hello. How are you?"
        }
      ],
      "error": null,
      "user": {
        "id": "11111111",
        "externalId": "user123",
        "createdAt": "2021-12-01T12:00:00Z",
        "lastSeen": "2022-01-01T12:00:00Z",
        "props": {
          "name": "Jane Doe",
          "email": "[e-mail]"
        }
      },
      "cost": 0.05,
      "params": {
        "temperature": 0.5,
        "maxTokens": 100,
        "tools": []
      },
      "metadata": null
    }
  ]
}

Authorizations

Authorization · string · header · required

Use a project private API key via Authorization: Bearer <key>.

Query Parameters

type · enum<string>

Available options: llm, trace, thread

search · string

models · string[]

tags · string[]

tokens · string

exportType · enum<string>

Available options: csv, jsonl

minDuration · string

maxDuration · string

startTime · string

endTime · string

parentRunId · string

limit · string

page · string

order · string

sortField · string

sortDirection · enum<string>

Available options: asc, desc

Response

200 - application/json

Successful response

total · number

page · number

limit · number

data · object[]

Show child attributes