List Steps

GET

/v1/steps

List steps with optional pagination and date filters. Dates should be provided in ISO 8601 format (e.g. 2025-01-29T15:01:19-08:00)

beforestringOptional

Return steps before this step ID

afterstringOptional

Return steps after this step ID

limitintegerOptional

Maximum number of steps to return

orderstringOptional

Sort order (asc or desc)

start_datestringOptional

Return steps after this ISO datetime (e.g. “2025-01-29T15:01:19-08:00”)

end_datestringOptional

Return steps before this ISO datetime (e.g. “2025-01-29T15:01:19-08:00”)

modelstringOptional

Filter by the name of the model used for the step

agent_idstringOptional

Filter by the ID of the agent that performed the step

Successful Response

list of objects or null

1	[
2	{
3	"id": "id",
4	"origin": "origin",
5	"provider_id": "provider_id",
6	"job_id": "job_id",
7	"agent_id": "agent_id",
8	"provider_name": "provider_name",
9	"model": "model",
10	"model_endpoint": "model_endpoint",
11	"context_window_limit": 1,
12	"completion_tokens": 1,
13	"prompt_tokens": 1,
14	"total_tokens": 1,
15	"completion_tokens_details": {
16	"key": "value"
17	},
18	"tags": [
19	"tags"
20	],
21	"tid": "tid",
22	"trace_id": "trace_id",
23	"messages": [
24	{
25	"role": "assistant",
26	"id": "message-123e4567-e89b-12d3-a456-426614174000"
27	}
28	]
29	}
30	]

1	curl https://app.letta.com/v1/steps \
2	-H "Authorization: Bearer <token>"