---
title: "List sessions"
method: GET
path: "/v1/sessions"
---

# List sessions

`GET /v1/sessions`

List all Devin sessions for your organization. Supports pagination and filtering by tags and user email.

## Query parameters

- `limit` integer
- `offset` integer
- `skip` integer, nullable
- `tags` string[], nullable — List of tags to filter sessions by.
- `user_email` string, nullable — Filter sessions by the creator's email address.

## Response `200`

Successful Response

- ListSessionsResponse — Response containing a list of sessions.
  - `sessions` SessionSummary[], required
    - `created_at` string, date-time, required
    - `playbook_id` string, nullable
    - `pull_request` PullRequestInfo — Pull request information associated with a session.
      - `url` string, required
    - `requesting_user_email` string, nullable
    - `session_id` string, required
    - `snapshot_id` string, nullable
    - `status` string, required
    - `status_enum` 'working' | 'blocked' | 'expired' | 'finished' | 'suspend_requested' | 'suspend_requested_frontend' | 'resume_requested' | 'resume_requested_frontend' | 'resumed', nullable
    - `structured_output` unknown
    - `tags` string[], nullable
    - `title` string, nullable
    - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/devin/apis/devin-api-v1.md) · [All operations](https://skmtc.net/devin/apis/devin-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devin/devin-api-v1/versions/e3244476af1c/schema)