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)

Query parameters

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

Response

Successful Response

idstring

The id of the step. Assigned by the database.

originstringOptional

The surface that this agent step was initiated from.

provider_idstringOptional

The unique identifier of the provider that was configured for this step

job_idstringOptional

The unique identifier of the job that this step belongs to. Only included for async calls.

provider_namestringOptional

The name of the provider used for this step.

modelstringOptional

The name of the model used for this step.

context_window_limitintegerOptional

The context window limit configured for this step.

completion_tokensintegerOptional

The number of tokens generated by the agent during this step.

prompt_tokensintegerOptional

The number of tokens in the prompt during this step.

total_tokensintegerOptional

The total number of tokens processed by the agent during this step.

completion_tokens_detailsmap from strings to anyOptional

Metadata for the agent.

tagslist of stringsOptional

Metadata tags.

tidstringOptional

The unique identifier of the transaction that processed this step.

messageslist of objectsOptional

The messages generated during this step.

Errors

Retrieve Step
Built with