> ## 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 Aria Agent Cloud Sessions

> List Aria Agent Cloud sessions, optionally filtered by agent, with cursor-based pagination compatible with the OpenAI Agents SDK.

List sessions. Optionally filter to sessions bound to a specific agent. Pagination is cursor-based using `after` and `limit`, matching the OpenAI Agents SDK.

## Endpoint

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

## Authentication

`Authorization: Bearer <api_key>` or `Authorization: ApiKey <api_key>`.

## Query parameters

<ParamField query="agent_id" type="string">
  Filter to sessions bound to one agent.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of sessions to return.
</ParamField>

<ParamField query="after" type="string">
  Cursor: session identifier to page after.
</ParamField>

## Response

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

<ResponseField name="data" type="array">
  Array of session objects (see [Get Session](/api-reference/agent/sessions/get)).
</ResponseField>

## Example

```bash theme={null}
curl "https://agent.example.com/v1/agents/sessions?agent_id=ag_0198a...&limit=20" \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "sess_0198c...",
      "object": "agent.session",
      "agent_id": "ag_0198a...",
      "status": "active",
      "created_at": 1735000000
    }
  ]
}
```


## Related topics

- [Update an Aria Agent Cloud Session](/api-reference/agent/sessions/update.md)
- [Create Aria Agent Cloud Session for an Agent](/api-reference/agent/sessions/create.md)
- [Retrieve an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/get.md)
- [Delete an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/delete.md)
- [Delete an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/delete.md)