> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Agent Turn

> Retrieve a specific turn in an agent session, including its nested items array and current status.

Use this endpoint to fetch a single turn by ID. The response includes the turn metadata and the full array of items that belong to this turn, such as messages and tool results.

## Endpoint

```http theme={null}
GET /v1/agents/sessions/{session_id}/turns/{turn_id}
```

## Authentication

Pass one of `Authorization: Bearer <api-key>` or `Authorization: ApiKey <key>`.

## Path Parameters

<ParamField path="session_id" type="string" required>
  The agent session identifier.
</ParamField>

<ParamField path="turn_id" type="string" required>
  The turn identifier.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique turn identifier.
</ResponseField>

<ResponseField name="session_id" type="string">
  The session this turn belongs to.
</ResponseField>

<ResponseField name="status" type="string">
  Turn status, for example `completed` or `in_progress`.
</ResponseField>

<ResponseField name="items" type="array">
  Array of item objects within the turn.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/turns/turn_01C \
    -H "Authorization: Bearer <api-key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "turn_01C",
    "session_id": "sess_01J5X8",
    "status": "completed",
    "items": [
      {
        "id": "msg_01A",
        "role": "user",
        "content": "Hello"
      },
      {
        "id": "msg_01B",
        "role": "assistant",
        "content": "Hi there"
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [Get Subagent Turn](/api-reference/agent/subagents/turn-get.md)
- [List Agent Turns](/api-reference/agent/turns/list.md)
- [Get an Agent](/api-reference/pin/agents/get.md)
- [List Agents - GET /v1/agents](/api-reference/agent/agents/list.md)
- [List Subagent Turns](/api-reference/agent/subagents/turns.md)
