---
title: "Find the campaigns using lists"
method: GET
path: "/lists/list/campaign-usage"
tags: ["Lists"]
---

# Find the campaigns using lists

`GET /lists/list/campaign-usage`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/lists/list/campaign-usage`
- Auth: API key in header `Authorization`

For each list id, returns the non-archived campaigns that include the list in their recipients. Use it to know whether adding contacts to a list will feed a campaign. Lists used only as exclusion lists are not reported. Ids that are not valid ObjectIds are dropped; ids of lists that are not yours return an empty array.

## Query parameters

- `listIds` string, required

## Response `200`

Campaigns per list id.

- ListsCampaignUsage
  - `usage` object, required: Keys are the requested list ids.

## Other responses

- `400`: `listIds` missing or empty.
- `401`: Missing, unknown or disabled API key, or the account of the key no longer exists. Note the body shape: `error` and `code`, not `message`.
- `500`: Unexpected server error. `error`, when present, is a raw internal message: do not parse it. Retry later.

---

[API](https://skmtc.dev/emelia/apis/emelia-api.md) · [All operations](https://skmtc.dev/emelia/apis/emelia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emelia/apis/emelia-api/revisions/8c0cb435f2c4?raw)