> ## 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.

# List Agent Turns

> Fetch completed turns for an agent session. Each turn groups one full user-input to model-response cycle.

A turn represents one complete interaction cycle in a session: the user input, any tool calls, and the final model response. Use this endpoint to list all completed turns for a given session.

## Endpoint

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

## 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>

## Response

<ResponseField name="object" type="string">
  Always `list`.
</ResponseField>

<ResponseField name="data" type="array">
  Array of turn objects.
</ResponseField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "turn_01C",
        "session_id": "sess_01J5X8",
        "status": "completed",
        "created_at": "2024-06-01T12:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [List Subagent Turns](/api-reference/agent/subagents/turns.md)
- [Get Agent Turn](/api-reference/agent/turns/get.md)
- [List Agents - GET /v1/agents](/api-reference/agent/agents/list.md)
- [List and Deploy Node Agents](/api-reference/pin/gpu-nodes/agents.md)
- [List Aria Agent Cloud Sessions](/api-reference/agent/sessions/list.md)