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

# GET /api/v1.0/messages/

`GET /api/v1.0/messages/`

ViewSet for Message model.

## Response `200`

- Message[]
  - `id` string, uuid, required — primary key for the record as UUID
  - `parent_id` string, uuid, nullable, required
  - `thread_id` string, uuid, nullable, required
  - `subject` string, nullable, required
  - `created_at` string, date-time, required — date and time at which a record was created
  - `updated_at` string, date-time, required — date and time at which a record was last updated
  - `htmlBody` MessageBodyItem[], required
    - `partId` string, required
    - `type` string, required
    - `content` string, required
  - `textBody` MessageBodyItem[], required
    - `partId` string, required
    - `type` string, required
    - `content` string, required
  - `draftBody` string, nullable, required
  - `attachments` Attachment[], required
    - `blobId` string, uuid, required
    - `name` string, required — Original filename of the attachment
    - `size` integer, required — Return the size of the associated blob.
    - `type` string, required
    - `sha256` string, required
    - `created_at` string, date-time, required — date and time at which a record was created
    - `cid` string, nullable, required — Content-ID for inline images
  - `sender` Contact, required — Serialize contacts.
    - `id` string, uuid, required — primary key for the record as UUID
    - `name` string, nullable
    - `email` string, email, required
  - `sender_user` MessageSenderUser, required — Lightweight serializer for the user who sent a message.
    - `id` string, uuid, required — primary key for the record as UUID
    - `full_name` string, nullable, required
    - `email` string, email, nullable, required
  - `to` MessageRecipient[], required
    - `id` string, uuid, required — primary key for the record as UUID
    - `contact` Contact, required — Serialize contacts.
      - `id` string, uuid, required — primary key for the record as UUID
      - `name` string, nullable
      - `email` string, email, required
    - `delivery_status` 'internal' | 'sent' | 'failed' | 'retry' | 'cancelled', required
    - `delivery_message` string, nullable, required
    - `retry_at` string, date-time, nullable, required
    - `delivered_at` string, date-time, nullable, required
  - `cc` MessageRecipient[], required
    - `id` string, uuid, required — primary key for the record as UUID
    - `contact` Contact, required — Serialize contacts.
      - `id` string, uuid, required — primary key for the record as UUID
      - `name` string, nullable
      - `email` string, email, required
    - `delivery_status` 'internal' | 'sent' | 'failed' | 'retry' | 'cancelled', required
    - `delivery_message` string, nullable, required
    - `retry_at` string, date-time, nullable, required
    - `delivered_at` string, date-time, nullable, required
  - `bcc` MessageRecipient[], required
    - `id` string, uuid, required — primary key for the record as UUID
    - `contact` Contact, required — Serialize contacts.
      - `id` string, uuid, required — primary key for the record as UUID
      - `name` string, nullable
      - `email` string, email, required
    - `delivery_status` 'internal' | 'sent' | 'failed' | 'retry' | 'cancelled', required
    - `delivery_message` string, nullable, required
    - `retry_at` string, date-time, nullable, required
    - `delivered_at` string, date-time, nullable, required
  - `sent_at` string, date-time, nullable, required
  - `is_sender` boolean, required
  - `is_draft` boolean, required
  - `is_unread` boolean, required
  - `is_trashed` boolean, required
  - `is_archived` boolean, required
  - `has_attachments` boolean, required
  - `mime_id` string, nullable, required
  - `signature` ReadMessageTemplate, required — Serialize message templates with dynamic body field inclusion. Body fields (html_body, text_body, raw_body) are only included when explicitly requested via the ``?bodies=`` query parameter or the ``body_fields`` keyword argument (for nested usage). Allowed values: ``raw``, ``html``, ``text`` (comma-separated). Mapping: ``raw`` → ``raw_body``, ``html`` → ``html_body``, ``text`` → ``text_body``. When neither query param nor kwarg is provided, no body field is returned.
    - `id` string, uuid, required — primary key for the record as UUID
    - `name` string, required — Name of the template (e.g., 'Standard Reply', 'Out of Office', 'Work Signature')
    - `html_body` string, nullable
    - `text_body` string, nullable
    - `raw_body` string, nullable
    - `type` 'message' | 'signature' | 'autoreply', required
    - `is_active` boolean, required — Whether this template is available for use
    - `is_forced` boolean, required — Whether this template is forced; no other template of the same type can be used in the same scope
    - `is_default` boolean, required — Whether this template is the default; it will be automatically loaded when composing a new message
    - `metadata` object
    - `signature` string, uuid, required — primary key for the record as UUID
    - `is_active_autoreply` boolean, nullable, required
    - `created_at` string, date-time, required — date and time at which a record was created
    - `updated_at` string, date-time, required — date and time at which a record was last updated
  - `stmsg_headers` object, required — Return the STMSG headers of the message.

---

[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)