Retrieve Company List Memberships

POST

/v1/lists/companies

Find out which lists each of your companies belongs to. Pass up to 100 company IDs in ids and get one entry per company, 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": [
        "159001425",
        "129011"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/json

Company list memberships retrieved

Bodyapplication/json

Examples

Default — the lists a company belongs to, by IDWith include=lists — each list in full

{
    "data": [
        {
            "type": "company",
            "id": "159001425",
            "relationships": {
                "lists": [
                    {
                        "type": "list",
                        "id": "company_123"
                    },
                    {
                        "type": "list",
                        "id": "company_456"
                    }
                ]
            }
        },
        {
            "type": "company",
            "id": "129011",
            "relationships": {
                "lists": []
            }
        }
    ],
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-08-31 12:06:53

Retrieve List Items

Retrieve Contact List Memberships