Sign in
Lists
v1

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. :::

post/v1/lists/companies

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

idsstring[] required

Company IDs to look up. A maximum of 100 IDs can be passed.

Example request

{
  "ids": [
    "159001425"
  ]
}

Response

Company list memberships retrieved

Example response

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

Changes

No changes recorded. 1 of the 15 revisions has no diff computed, so it could not be searched.