---
title: "List contacts"
method: GET
path: "/api/v1/contacts"
tags: ["Contacts"]
---

# List contacts

`GET /api/v1/contacts`

## Request

- Base URL: `https://api.misar.io/mail`
- URL: `https://api.misar.io/mail/api/v1/contacts`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `status` 'subscribed' | 'unsubscribed' | 'bounced'

## Response `200`

Contact list

- object
  - `success` boolean
  - `data` Contact[]
    - `id` string, uuid
    - `email` string, email
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `status` 'subscribed' | 'unsubscribed' | 'bounced' | 'complained'
    - `tags` string[]
    - `created_at` string, date-time
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

---

[API](https://skmtc.dev/misar/apis/misarmail-api.md) · [All operations](https://skmtc.dev/misar/apis/misarmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/misar/apis/misarmail-api/revisions/1141238bc092?raw)