---
title: "Changes to Retrieves a run step."
method: GET
path: "/threads/{thread_id}/runs/{run_id}/steps/{step_id}"
---

# Changes to Retrieves a run step.

`GET /threads/{thread_id}/runs/{run_id}/steps/{step_id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 35 revisions.

- **2024-08-29** `1dbac0e95bdb` — 3 info

## Changes

- **2024-08-29** `1dbac0e95bdb` — 3 info
  - added the new optional `query` request parameter `include[]`
  - added the optional property `step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/ranking_options` to the response with the `200` status
  - added the optional property `step_details/oneOf[subschema #2: Tool calls]/tool_calls/items/oneOf[subschema #2: File search tool call]/file_search/results` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openai-api-2/docs/threads/:thread_id/runs/:run_id/steps/:step_id/get.md) · [API](https://skmtc.dev/openai/apis/openai-api-2.md) · [Page](https://skmtc.dev/openai/apis/openai-api-2/changes/threads/:thread_id/runs/:run_id/steps/:step_id/get)