LEleadfeeder
Lists
v1

Retrieve Company List Memberships

Changed on

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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/lists/companies
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: lists:read

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": [
    {
      "id": "129011",
      "relationships": {
        "lists": [
          {
            "id": "company_123",
            "type": "list"
          }
        ]
      },
      "type": "company"
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • ac752c6c2be0Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status