v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Miscellaneous

Get a List of All Lists

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

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.

get/labels

Response

200

_idstring

cached_countinteger

concurrency_locksobject

created_atstring

modalitystring

namestring

need_cached_count_updateboolean

needs_count_update_atstring

{"stackTrail":"paths:/labels:get:responses:200:content:application/json:schema:items:properties:rule_config_template_id","oasType":"schema","type":"unknown"}

team_idstring

updated_atstring

user_idstring

idstring

keystring

Example response

[
  {
    "_id": "66e9e215ece19801b2199981",
    "cached_count": 1,
    "created_at": "2024-09-17T20:09:57.863Z",
    "modality": "emailer_campaigns",
    "name": "Dublin market",
    "needs_count_update_at": "2024-09-17T20:09:57.885+00:00",
    "team_id": "6095a710bd01d100a506d4ac",
    "updated_at": "2024-09-17T20:09:57.910Z",
    "user_id": "66302798d03b9601c7934ebf",
    "id": "66e9e215ece19801b2199981",
    "key": "66e9e215ece19801b2199981"
  }
]