# Get a List of All Lists
Use the Get a List of All Lists endpoint to retrieve information about every list that has been created in your Apollo account. This endpoint can be used to check the available lists before you use the Create a Contact endpoint.
This endpoint does not require any parameters.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "apollo-rest-api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.apollo.io/api/v1"
}
],
"components": {
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "header",
"name": "x-api-key",
"description": "API key"
},
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "[Recommended] OAuth Access token"
}
}
},
"security": [
{
"bearerAuth": []
},
{
"apiKey": []
}
],
"paths": {
"/labels": {
"get": {
"summary": "Get a List of All Lists",
"description": "Use the Get a List of All Lists endpoint to retrieve information about every list that has been created in your Apollo account. This endpoint can be used to check the available lists before you use the Create a Contact endpoint.
This endpoint does not require any parameters.
This endpoint requires a master API key. If you attempt to call the endpoint without a master key, you will receive a `403` response. Refer to Create API Keys to learn how to create a master API key.",
"operationId": "get-a-list-of-all-lists",
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": [
{
"_id": "66e9e215ece19801b2199981",
"cached_count": 1,
"concurrency_locks": {},
"created_at": "2024-09-17T20:09:57.863Z",
"modality": "emailer_campaigns",
"name": "Dublin market",
"need_cached_count_update": false,
"needs_count_update_at": "2024-09-17T20:09:57.885+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-09-17T20:09:57.910Z",
"user_id": "66302798d03b9601c7934ebf",
"id": "66e9e215ece19801b2199981",
"key": "66e9e215ece19801b2199981"
},
{
"_id": "6660862c078cf0038abedb64",
"cached_count": 25,
"concurrency_locks": {},
"created_at": "2024-06-05T15:37:16.684Z",
"modality": "contacts",
"name": "Conference 2024 - Maui",
"need_cached_count_update": false,
"needs_count_update_at": "2024-06-05T15:37:16.708+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-06-05T15:37:16.738Z",
"user_id": "66302798d03b9601c7934ec2",
"id": "6660862c078cf0038abedb64",
"key": "6660862c078cf0038abedb64"
},
{
"_id": "66e361494acd1307386d4073",
"cached_count": 0,
"concurrency_locks": {},
"created_at": "2024-09-12T21:46:49.464Z",
"modality": "contacts",
"name": "2024 fiction writers of america attendees",
"need_cached_count_update": false,
"needs_count_update_at": "2024-09-13T00:43:17.703+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-09-13T00:47:35.416Z",
"user_id": "60affe7d6e270a00f5db6fe4",
"id": "66e361494acd1307386d4073",
"key": "66e361494acd1307386d4073"
},
{
"_id": "66ad0f4bc1a9d50001765e61",
"cached_count": 11,
"concurrency_locks": {},
"created_at": "2024-08-02T16:54:35.303Z",
"modality": "contacts",
"name": "Demo Meeting Booked",
"need_cached_count_update": false,
"needs_count_update_at": "2024-09-17T22:44:30.338+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-09-17T22:44:30.370Z",
"user_id": "6578a336d8ecfd03eca315d8",
"id": "66ad0f4bc1a9d50001765e61",
"key": "66ad0f4bc1a9d50001765e61"
},
{
"_id": "660333cbb93a2102e8f00331",
"cached_count": 83,
"concurrency_locks": {},
"created_at": "2024-03-26T20:44:59.053Z",
"modality": "contacts",
"name": "Trade Show Leads",
"need_cached_count_update": false,
"needs_count_update_at": "2024-03-26T20:45:03.106+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-03-26T20:45:03.139Z",
"user_id": "60affe7d6e270a00f5db6fe4",
"id": "660333cbb93a2102e8f00331",
"key": "660333cbb93a2102e8f00331"
},
{
"_id": "6614710916c22b01c7dd5e9b",
"cached_count": 8,
"concurrency_locks": {},
"created_at": "2024-04-08T22:34:49.454Z",
"modality": "accounts",
"name": "CSV Import",
"need_cached_count_update": false,
"needs_count_update_at": "2024-04-08T22:34:49.489+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-04-08T22:37:23.037Z",
"user_id": "60affe7d6e270a00f5db6fe4",
"id": "6614710916c22b01c7dd5e9b",
"key": "6614710916c22b01c7dd5e9b"
},
{
"_id": "6625244b0909d600078ad116",
"cached_count": 229,
"concurrency_locks": {},
"created_at": "2024-04-21T14:35:55.672Z",
"modality": "contacts",
"name": "Cold Call Leads",
"need_cached_count_update": false,
"needs_count_update_at": "2024-05-21T21:11:06.074+00:00",
"rule_config_template_id": null,
"team_id": "6095a710bd01d100a506d4ac",
"updated_at": "2024-05-21T21:11:06.106Z",
"user_id": "60affe7d6e270a00f5db6fe4",
"id": "6625244b0909d600078ad116",
"key": "6625244b0909d600078ad116"
}
]
}
},
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"_id": {
"type": "string",
"example": "66e9e215ece19801b2199981"
},
"cached_count": {
"type": "integer",
"example": 1,
"default": 0
},
"concurrency_locks": {
"type": "object",
"properties": {}
},
"created_at": {
"type": "string",
"example": "2024-09-17T20:09:57.863Z"
},
"modality": {
"type": "string",
"example": "emailer_campaigns"
},
"name": {
"type": "string",
"example": "Dublin market"
},
"need_cached_count_update": {
"type": "boolean",
"example": false,
"default": true
},
"needs_count_update_at": {
"type": "string",
"example": "2024-09-17T20:09:57.885+00:00"
},
"rule_config_template_id": {},
"team_id": {
"type": "string",
"example": "6095a710bd01d100a506d4ac"
},
"updated_at": {
"type": "string",
"example": "2024-09-17T20:09:57.910Z"
},
"user_id": {
"type": "string",
"example": "66302798d03b9601c7934ebf"
},
"id": {
"type": "string",
"example": "66e9e215ece19801b2199981"
},
"key": {
"type": "string",
"example": "66e9e215ece19801b2199981"
}
}
}
}
}
}
},
"401": {
"description": "401",
"content": {
"text/plain": {
"examples": {
"Check API key": {
"value": "Invalid access credentials."
}
}
}
}
},
"403": {
"description": "403",
"content": {
"application/json": {
"examples": {
"Need master API key": {
"value": "{\n \"error\": \"api/v1/labels/index is not accessible with this api_key\",\n \"error_code\": \"API_INACCESSIBLE\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"example": "api/v1/labels/index is not accessible with this api_key"
},
"error_code": {
"type": "string",
"example": "API_INACCESSIBLE"
}
}
}
}
}
},
"429": {
"description": "429",
"content": {
"application/json": {
"examples": {
"Too many requests": {
"value": "{\n \"message\": \"The maximum number of api calls allowed for api/v1/labels is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade.\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "The maximum number of api calls allowed for api/v1/labels is 600 times per hour. Please upgrade your plan from https://app.apollo.io/#/settings/plans/upgrade."
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [
{
"key": "Cache-Control",
"value": "no-cache"
},
{
"key": "Content-Type",
"value": "application/json"
}
],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```