Lists
v1
Retrieve Contact List Memberships
Find out which lists each of your contacts belongs to. Pass up to 100 contact IDs in ids and get one entry per contact, in the same order.
Each entry names the lists by ID. Pass include=lists to get each list's full details instead, so you do not need a second call to resolve names.
Credit Note: This endpoint does not consume credits.
:::info Requires the lists:read OAuth2 scope. :::
post/v1/lists/contacts
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
include'lists'
Pass lists to include each list's full details in the response instead of bare references.
Request body
Example request
{
"ids": [
"3219787601"
]
}Response
Contact list memberships retrieved
Example response
{
"data": [
{
"type": "contact",
"id": "435834",
"relationships": {
"lists": [
{
"type": "list",
"id": "company_123"
}
]
}
}
],
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}