---
title: "List Contacts"
method: GET
path: "/v3/lists/{listId}/subscribers"
tags: ["Subscribers"]
---

# List Contacts

`GET /v3/lists/{listId}/subscribers`

This endpoint helps you to return a list of all contacts previously added for a given list. Query parameters and extra filters can be added using list's columns (e.g. email[like]=tester@example.com, age[gt]=30)

## Path parameters

- `listId` integer, required

## Query parameters

- `limit` integer
- `skip` integer
- `offset` string
- `sort` string
- `select` string

## Response `200`

Successfully retrieved the contacts

- SubscribersResponse
  - `meta` MetadataDTO
    - `timestamp` integer, required — Transaction's date in timestamp
    - `transactionId` string, required — Id for the current transaction (Endpoint's call)
    - `explain` string — Explain string in case of failure
  - `pagination` PageDTO — pagination information
    - `offset` string — start point
    - `limit` integer — items to be displayed by page
    - `next` string — next item to be consulted in the following invocation
    - `page` integer — current page of data
    - `pages` integer — total amount of pages in the response
    - `total` integer — total amount of items in the response
  - `items` SubscriberDTO[] — list of contacts
    - `id` string, required — Unique identifier of the blocklisted contact.
    - `to` string, required — <p>Contact data you want to add to the blocklist according to the sending entity and delivery channel.</p> <p>To add a contact to the blocklist via SMS, WhatsApp or RCS, you need to provide the phone number of the contact.</p><p>To add a contact to the blocklist via Email, you need to provide the email address of the contact.</p>
    - `reason` string, required — The reason why the contact is added to the blocklist.
    - `date` string, date-time — Date when the contact was added to the blocklist.

## Other responses

- `404` — Resource not found
- `409` — Duplicated data
- `500` — Internal server error

---

[API](https://skmtc.net/messangi/apis/raven.md) · [All operations](https://skmtc.net/messangi/apis/raven/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messangi/raven/versions/c87f398fa338/schema)