Retrieve Contact List Memberships

POST

/v1/lists/contacts

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.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Example

{
    "ids": [
        "3219787601",
        "3219787635"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/lists/contacts?account_id=123456&include=undefined' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "ids": [
        "3219787601",
        "3219787635"
    ]
}'

Responses

🟢200OK

application/json

Contact list memberships retrieved

Bodyapplication/json

Examples

With include=lists — each list in fullDefault — the lists a contact belongs to, by ID

{
    "data": [
        {
            "id": "3219787601",
            "relationships": {
                "lists": [
                    {
                        "attributes": {
                            "created_at": "2024-12-10T15:57:25Z",
                            "name": "Decision Makers",
                            "scope": "contact",
                            "updated_at": "2024-11-24T11:50:00Z"
                        },
                        "id": "contact_321",
                        "relationships": {
                            "created_by": {
                                "id": "12345",
                                "type": "user"
                            }
                        },
                        "type": "list"
                    }
                ]
            },
            "type": "contact"
        },
        {
            "id": "3219787635",
            "relationships": {
                "lists": []
            },
            "type": "contact"
        }
    ],
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-10-13 07:27:21

Retrieve Company List Memberships

Delete List