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

# GET /api/v1.0/maildomains/

`GET /api/v1.0/maildomains/`

List mail domains, optionally filtered by name with the `q` parameter.

## Query parameters

- `page` integer
- `q` string

## Response `200`

- PaginatedMailDomainAdminList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` MailDomainAdmin[], required
    - `id` string, uuid, required — primary key for the record as UUID
    - `name` string, 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
    - `expected_dns_records` object[], nullable, required
      - `target` string, required
      - `type` string, required
      - `value` string, required
    - `mailbox_count` string, required
    - `identity_sync` boolean, required — Sync mailboxes to an identity provider.
    - `abilities` object, required — Instance permissions and capabilities
      - `get` boolean, required — Can read
      - `post` boolean, required — Can create
      - `put` boolean, required — Can update
      - `patch` boolean, required — Can partially update
      - `delete` boolean, required — Can delete
      - `manage_accesses` boolean, required — Can manage accesses
      - `manage_mailboxes` boolean, required — Can manage mailboxes

## Changes

- **2026-06-23** `302e2aacc458` — 2 breaking
  - the response property `results/items/expected_dns_records` became nullable for the status `200`
  - the `results/items/expected_dns_records` response's property type changed from `string` to `array` for status `200`
- **2026-05-16** `1c0d6cb80572` — 2 info
  - added the new optional `query` request parameter `q`
  - added the required property `results/items/mailbox_count` to the response with the `200` status
- **2026-02-19** `ca569bc2da30` — 1 info
  - added the required property `results/items/identity_sync` to the response with the `200` status

[Change history](https://skmtc.dev/betagouv/apis/messages-api/changes/api/v1.0/maildomains/get.md)

---

[API](https://skmtc.dev/betagouv/apis/messages-api.md) · [All operations](https://skmtc.dev/betagouv/apis/messages-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/betagouv/messages-api/revisions/ba0c140b76dd/schema)