Sample - OpenAI API
GET/threads/{thread_id}/runs/{run_id}/steps

List the steps in a run

Lists the steps belonging to a run. Use limit, order, and cursor parameters to control the page, and use include[] to request file search result content in step details.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

7 parameters
thread_idstringrequired
The identifier of the thread containing the run and its steps.
run_idstringrequired
The identifier of the run whose steps to list.
limitintegeroptional
Maximum number of run steps to return, from 1 to 100. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order by creation time: `asc` or `desc`. Defaults to `desc` when omitted.
Allowed:ascdescDefault:desc
afterstringoptional
Cursor identifying the last object in the previous page; use it to retrieve the next page.
beforestringoptional
Cursor identifying the first object in the current page; use it to retrieve the previous page.
include[]array<string>optional
Additional response fields to include. The supported value is `step_details.tool_calls[*].file_search.results[*].content`.

2 status codes
200Returns a paginated run-step collection containing the step data, first and last object identifiers, and a `has_more` indicator.
objectstringrequired
dataarray<RunSteps>required
first_idstringrequired
last_idstringrequired
has_morebooleanrequired
429Returned when the request was rejected because a rate limit was exceeded.
errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. limit must be between 1 and 100, order must be asc or desc, and each include[] value must be step_details.tool_calls[*].file_search.results[*].content.