---
title: "GET /api/v1.0/threads/"
method: GET
path: "/api/v1.0/threads/"
tags: ["threads"]
---

# GET /api/v1.0/threads/

`GET /api/v1.0/threads/`

List threads with optional search functionality.

## Query parameters

- `has_active` integer
- `has_archived` integer
- `has_assigned_to_me` integer
- `has_attachments` integer
- `has_delivery_pending` integer
- `has_draft` integer
- `has_mention` integer
- `has_messages` integer
- `has_sender` integer
- `has_starred` integer
- `has_trashed` integer
- `has_unassigned` integer
- `has_unread` integer
- `has_unread_mention` integer
- `is_spam` integer
- `is_trashed` integer
- `label_slug` string
- `mailbox_id` string, uuid
- `page` integer
- `search` string

## Response `200`

- PaginatedThreadList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Thread[], required
    - `id` string, uuid, required — primary key for the record as UUID
    - `subject` string, nullable, required
    - `snippet` string, required
    - `messages` string, required
    - `has_unread` boolean, required
    - `has_unread_mention` boolean, required
    - `has_trashed` boolean, required
    - `is_trashed` boolean, required — Whether all messages in the thread are trashed
    - `has_archived` boolean, required
    - `has_draft` boolean, required
    - `has_starred` boolean, required
    - `has_attachments` boolean, required
    - `has_sender` boolean, required
    - `has_messages` boolean, required
    - `has_delivery_failed` boolean, required — True if thread has messages with permanent delivery failure.
    - `has_delivery_pending` boolean, required — True if thread has messages awaiting successful delivery (sending, retrying, or failed).
    - `is_spam` boolean, required
    - `has_active` boolean, required
    - `messaged_at` string, date-time, nullable, required
    - `active_messaged_at` string, date-time, nullable, required — Date of the last active (received, not spam/archived/trashed/draft) message.
    - `draft_messaged_at` string, date-time, nullable, required — Date of the last draft (non-trashed) message.
    - `sender_messaged_at` string, date-time, nullable, required — Date of the last sent (non-trashed, non-draft) message.
    - `archived_messaged_at` string, date-time, nullable, required — Date of the last archived (non-trashed) message.
    - `trashed_messaged_at` string, date-time, nullable, required — Date of the last trashed message.
    - `sender_names` string[], required
    - `updated_at` string, date-time, required — date and time at which a record was last updated
    - `user_role` 'viewer' | 'editor', required
    - `accesses` ThreadAccessDetail[], required
      - `id` string, uuid, required — primary key for the record as UUID
      - `mailbox` MailboxLight, required — Serializer for mailbox details in thread access.
        - `id` string, uuid, required — primary key for the record as UUID
        - `email` string, required
        - `name` string, required
        - `is_identity` boolean, required — Whether this mailbox identifies a person (i.e. is not an alias or a group)
      - `role` 'viewer' | 'editor', required
      - `read_at` string, date-time, nullable, required
      - `starred_at` string, date-time, nullable, required
    - `labels` ThreadLabel[], required
      - `id` string, uuid, required — primary key for the record as UUID
      - `name` string, required — Name of the label/folder (can use slashes for hierarchy, e.g. 'Work/Projects')
      - `slug` string, required — URL-friendly version of the name
      - `color` string — Color of the label in hex format (e.g. #FF0000)
      - `display_name` string, required
      - `description` string — Description of the label, used by AI to understand its purpose
      - `is_auto` boolean — Whether this label should be automatically applied by AI
    - `summary` string, required
    - `events_count` integer, required
    - `abilities` object, required
    - `assigned_users` ThreadEventUser[], required
      - `id` string, uuid, required
      - `name` string, required

---

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