Retrieve Company List Memberships

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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Company list memberships retrieved

Bodyapplication/json

Examples

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

{
    "data": [
        {
            "id": "159001425",
            "relationships": {
                "lists": [
                    {
                        "attributes": {
                            "created_at": "2024-12-10T15:57:25Z",
                            "name": "US Prospects",
                            "scope": "company",
                            "updated_at": "2024-11-24T11:50:00Z"
                        },
                        "id": "company_123",
                        "relationships": {
                            "created_by": {
                                "id": "12345",
                                "type": "user"
                            }
                        },
                        "type": "list"
                    },
                    {
                        "attributes": {
                            "created_at": "2024-12-11T09:12:03Z",
                            "name": "Target Accounts",
                            "scope": "company",
                            "updated_at": "2024-12-11T09:12:03Z"
                        },
                        "id": "company_456",
                        "relationships": {
                            "created_by": {
                                "id": "12345",
                                "type": "user"
                            }
                        },
                        "type": "list"
                    }
                ]
            },
            "type": "company"
        },
        {
            "id": "129011",
            "relationships": {
                "lists": []
            },
            "type": "company"
        }
    ],
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

🔴504Gateway Timeout