Runs

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

curl --request GET \
  --url https://api.lunary.ai/v1/runs \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: application/json'

Parameters

Name	Located In	Required	Schema
type	query	No	string
search	query	No	string
models	query	No	array
tags	query	No	array
tokens	query	No	string
exportType	query	No	string
minDuration	query	No	string
maxDuration	query	No	string
startTime	query	No	string
endTime	query	No	string
parentRunId	query	No	string
limit	query	No	string
page	query	No	string
order	query	No	string
sortField	query	No	string
sortDirection	query	No	string

Responses

200

Successful response

Property	Type	Description
total	number
page	number
limit	number
data	array

Get runs

Parameters

Responses

200

Questions? We're here to help.