---
title: "Get all the contacts"
method: GET
path: "/contacts"
tags: ["Contacts"]
---

# Get all the contacts

`GET /contacts`

## Query parameters

- `limit` integer
- `offset` integer
- `modifiedSince` string
- `createdSince` string
- `sort` 'asc' | 'desc'
- `segmentId` integer
- `listIds` integer[]
- `filter` string

## Response `200`

All contacts listed

- GetContacts
  - `contacts` GetContactDetails[], required
    - `email` string, email — Email address of the contact for which you requested the details
    - `id` integer, required — ID of the contact for which you requested the details
    - `emailBlacklisted` boolean, required — Blacklist status for email campaigns (true=blacklisted, false=not blacklisted)
    - `smsBlacklisted` boolean, required — Blacklist status for SMS campaigns (true=blacklisted, false=not blacklisted)
    - `createdAt` string, required — Creation UTC date-time of the contact (YYYY-MM-DDTHH:mm:ss.SSSZ)
    - `modifiedAt` string, required — Last modification UTC date-time of the contact (YYYY-MM-DDTHH:mm:ss.SSSZ)
    - `listIds` integer[], required
    - `listUnsubscribed` integer[]
    - `attributes` object, required — Set of attributes of the contact
  - `count` integer, required — Number of contacts

## Other responses

- `400` — bad request

## Changes

- **2026-07-17** `2aec3cf66501` — 3 info
  - added the new optional `query` request parameter `filter`
  - added the new optional `query` request parameter `listIds`
  - added the new optional `query` request parameter `segmentId`
- **2023-05-05** `2122e9ffdbe8` — 3 warning
  - deleted the `query` request parameter `filter`
  - deleted the `query` request parameter `listIds`
  - deleted the `query` request parameter `segmentId`

[Change history](https://skmtc.dev/getbrevo/apis/brevo-api/changes/contacts/get.md)

---

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