---
title: "Gets a customer list by ID."
method: GET
path: "/api/v2/target-group/customer-list/{list-id}"
tags: ["target-group"]
---

# Gets a customer list by ID.

`GET /api/v2/target-group/customer-list/{list-id}`

## Path parameters

- `list-id` string, required

## Query parameters

- `skip` integer
- `take` integer

## Response `200`

Success

- OptimoveAPIModelsGetCustomerListResponse — Response model for getting a customer list.
  - `list-id` string, nullable
  - `list-name` string, nullable
  - `total-count` integer
  - `customers` string[], nullable

## Other responses

- `400` — Bad Request

---

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