---
title: "Get a list's details"
method: GET
path: "/contacts/lists/{listId}"
tags: ["Contacts"]
---

# Get a list's details

`GET /contacts/lists/{listId}`

## Path parameters

- `listId` integer, required

## Query parameters

- `startDate` string
- `endDate` string

## Response `200`

List informations

- GetExtendedList
  - `id` integer, required — ID of the list
  - `name` string, required — Name of the list
  - `totalBlacklisted` integer, required — Number of blacklisted contacts in the list
  - `totalSubscribers` integer, required — Number of contacts in the list
  - `uniqueSubscribers` integer, required — Number of unique contacts in the list
  - `folderId` integer, required — ID of the folder
  - `createdAt` string, required — Creation UTC date-time of the list (YYYY-MM-DDTHH:mm:ss.SSSZ)
  - `campaignStats` GetExtendedListCampaignStats[]
    - `campaignId` integer, required — ID of the campaign
    - `stats` GetCampaignStats, required
      - `listId` integer — List Id of email campaign (only in case of get email campaign(s)(not for global stats))
      - `uniqueClicks` integer, required — Number of unique clicks for the campaign
      - `clickers` integer, required — Number of total clicks for the campaign
      - `complaints` integer, required — Number of complaints (Spam reports) for the campaign
      - `delivered` integer, required — Number of delivered emails for the campaign
      - `sent` integer, required — Number of sent emails for the campaign
      - `softBounces` integer, required — Number of softbounce for the campaign
      - `hardBounces` integer, required — Number of harbounce for the campaign
      - `uniqueViews` integer, required — Number of unique openings for the campaign
      - `trackableViews` integer, required — Recipients without any privacy protection option enabled in their email client
      - `trackableViewsRate` number, float — Rate of recipients without any privacy protection option enabled in their email client
      - `estimatedViews` integer — Rate of recipients without any privacy protection option enabled in their email client, applied to all delivered emails
      - `unsubscriptions` integer, required — Number of unsubscription for the campaign
      - `viewed` integer, required — Number of openings for the campaign
      - `deferred` integer — Number of deferred emails for the campaign
      - `returnBounce` integer — Total number of non-delivered campaigns for a particular campaign id.
  - `dynamicList` boolean — Status telling if the list is dynamic or not (true=dynamic, false=not dynamic)

## Other responses

- `400` — bad request
- `404` — List ID not found

---

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