---
title: "Get a List of All Lists"
method: GET
path: "/labels"
tags: ["Miscellaneous"]
---

# Get a List of All Lists

`GET /labels`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

Use the Get a List of All Lists endpoint to retrieve information about every <a href="https://knowledge.apollo.io/hc/en-us/articles/4409728608525-Create-and-Use-a-List" target="_blank">list</a> that has been created in your Apollo account. This endpoint can be used to check the available lists before you use the <a href="https://docs.apollo.io/reference/create-a-contact">Create a Contact endpoint</a>. <br><br>This endpoint doesn't require any parameters.<br><br>This endpoint requires a master API key. If you call the endpoint without a master key, you receive a `403` response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master key.

## Response `200`

200

- object[]
  - `_id` string
  - `cached_count` integer
  - `concurrency_locks` object
  - `created_at` string
  - `modality` string
  - `name` string
  - `need_cached_count_update` boolean
  - `needs_count_update_at` string
  - `rule_config_template_id` unknown
  - `team_id` string
  - `updated_at` string
  - `user_id` string
  - `id` string
  - `key` string

## Other responses

- `401` — 401
- `403` — 403
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)