## List remote sessions ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
160 lines, first recorded
/
lines
The first capture of this source. The page was already there, and this is what it said.
---
title: List remote sessions
url: https://platform.claude.com/docs/en/api/compliance/apps/sessions/remote/list
---
## List remote sessions
**get** `/v1/compliance/apps/sessions/remote`
List remote sessions (Cowork sessions that run in Anthropic-managed
cloud environments) across the organizations the key may read.
Each entry carries session metadata only; retrieve a session's
transcript from the messages endpoint. By default the list spans every
such organization; pass up to 500 `organization_ids[]` values to
narrow it. Pass 1 to 10 `user_ids[]` values to scope the
list to specific users: that filter matches the session's owning user,
so agent-owned sessions are excluded whenever it is set. Bound results
in time with the `created_at` range parameters (`created_at.gte`,
`created_at.gt`, `created_at.lt`, `created_at.lte`; RFC 3339). There
is no `updated_at` filter.
Results are sorted newest first by `created_at`, with at most `limit`
sessions per page (default 100, maximum 500). Pagination is
forward-only: pass the response's `next_page` value back as `page` to
retrieve the next page, and stop when `next_page` is null.
### Query Parameters
- `created_at: optional object { gt, gte, lt, lte }`
- `gt: optional string`
Filter remote sessions created after this time (RFC 3339 format)
- `gte: optional string`
Filter remote sessions created at or after this time (RFC 3339 format)
- `lt: optional string`
Filter remote sessions created before this time (RFC 3339 format)
- `lte: optional string`
Filter remote sessions created at or before this time (RFC 3339 format)
- `limit: optional number`
Maximum results (default: 100, max: 500)
- `organization_ids: optional array of string`
Filter to specific child organization identifiers. Omit to enumerate every child organization the key may read.
- `page: optional string`
Opaque pagination token from a previous response's `next_page` field. Pass this to retrieve the next page of results. Clients should treat this value as an opaque string and not attempt to parse or interpret its contents, as the format may change without notice.
- `user_ids: optional array of string`
Filter to sessions owned by specific users (max 10 per request). Agent-owned sessions are excluded when this filter is set.
### Header Parameters
- `"x-api-key": optional string`
### Returns
- `data: array of object { id, agent_id, claude_project_id, 7 more }`
- `id: string`
Remote session identifier
- `agent_id: string or null`
Identifier of the automated agent that owns the session. Null for user-owned sessions. At most one of `user` and `agent_id` is set.
- `claude_project_id: string or null`
ID of the project the session is bound to. Null when the session has no project binding.
- `created_at: string`
When the session was created (RFC 3339, UTC)
- `organization_uuid: string`
UUID of the organization the session belongs to
- `product_surface: string or null`
The Claude product the session was created from. Currently `cowork_remote`, for Cowork sessions started on claude.ai web or mobile. More values will appear as other surfaces launch, so treat any unrecognized value as an unclassified surface rather than an error. Null for sessions created before this field was recorded, for surfaces that do not stamp it, and for unrecognized tag values.
- `started_by_user: object { id, email_address } or null`
A user associated with a remote session.
- `id: string`
User identifier
- `email_address: string or null`
User's email address. Null when the user is no longer a member of an organization the key may read — `id` remains set so attribution is preserved. The messages endpoint does not resolve email addresses; this field is always null there.
- `status: string`
Session lifecycle state. One of `active`, `paused`, `archived`, or `failed` — the lifecycle states the owning product surface exposes — plus `pending`, a brief transient state that resolves before any transcript content exists. The list endpoint includes `pending`; the messages endpoint returns 404 for it. Deleted sessions are not returned on either endpoint. Treat unrecognized values as an unknown state rather than an error.
- `updated_at: string`
When the session was last modified (RFC 3339, UTC)
- `user: object { id, email_address } or null`
A user associated with a remote session.
- `id: string`
User identifier
- `email_address: string or null`
User's email address. Null when the user is no longer a member of an organization the key may read — `id` remains set so attribution is preserved. The messages endpoint does not resolve email addresses; this field is always null there.
- `next_page: string or null`
Opaque page token; pass as `page` to retrieve the next page. Null when no rows exist after this page. Treat this value as opaque; do not parse or store it long-term, as the format may change without notice.
### Example
```http
curl https://api.anthropic.com/v1/compliance/apps/sessions/remote \
-H "Authorization: Bearer $ANTHROPIC_COMPLIANCE_API_KEY"
```
#### Response
```json
{
"data": [
{
"id": "cse_01A0000000000000000000000",
"organization_uuid": "00000000-0000-0000-0000-000000000000",
"user": {
"id": "user_01A0000000000000000000000",
"email_address": "[email protected]"
},
"status": "active",
"created_at": "2026-01-02T03:04:05.000000Z",
"updated_at": "2026-01-02T03:04:05.000000Z",
"product_surface": "cowork_remote",
"claude_project_id": "claude_proj_01Nm7PqRsTuVwXyZaBcDeFgH"
}
],
"next_page": "page_AAE..."
}
```