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

# List contacts

`GET /api/reach/v1/contacts`

> **Deprecated.**

Get a list of contacts, optionally filtered by group and subscription status.

This endpoint returns a paginated list of contacts with their basic information.
You can filter contacts by group UUID and subscription status.

**Deprecated.** This endpoint cannot target a profile, so it always falls back to the
client's default profile and cannot list contacts of any other profile. Use
`GET /api/reach/v1/profiles/{profileUuid}/contacts` instead, which also replaces the
group filter with a tag filter.

## Query parameters

- `group_uuid` string
- `subscription_status` 'subscribed' | 'unsubscribed' | 'confirmed' | 'pending'
- `page` integer

## Response `200`

Success response

- object
  - `data` ReachV1ContactsContactResource[] — Array of [`Reach.V1.Contacts.ContactResource`](#model/reachv1contactscontactresource)
    - `uuid` string
    - `name` string, nullable
    - `surname` string, nullable
    - `email` string
    - `subscription_status` 'subscribed' | 'unsubscribed' | 'confirmed' | 'pending'
    - `subscribed_at` string, date-time
    - `source` 'sync' | 'import' | 'manual' | 'api' | 'form' | 'checkout' | 'horizons', nullable
    - `note` string, nullable
  - `meta` CommonSchemaPaginationMetaSchema
    - `current_page` integer
    - `per_page` integer
    - `total` integer

## Other responses

- `401` — Unauthenticated response
- `500` — Error response

---

[API](https://skmtc.net/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.net/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/74abfea76e36/schema)