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

# GET /api/v1.0/contacts/

`GET /api/v1.0/contacts/`

List contacts with optional filtering by mailbox and search query.
For a mailbox, it returns all contacts in the mailbox and all contacts
in the same domain as the mailbox.

Query parameters:
- mailbox_id: Optional UUID to filter contacts by mailbox
- q: Optional search query for name or email (case insensitive)

## Query parameters

- `mailbox_id` string, uuid
- `q` string

## Response `200`

- Contact[]
  - `id` string, uuid, required — primary key for the record as UUID
  - `name` string, nullable
  - `email` string, required

## Changes

- **2026-08-28** `ba0c140b76dd` — 1 breaking
  - the `items/email` response's property type/format changed from `string`/`email` to `string`/`` for status `200`

[Change history](https://skmtc.dev/betagouv/apis/messages-api/changes/api/v1.0/contacts/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)