LEleadfeeder
Lists
v1

Retrieve Contact List Memberships

Changed on

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

post/v1/lists/contacts

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/lists/contacts
  • 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

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

Example request

{
  "ids": [
    "3219787601"
  ]
}

Response

Contact list memberships retrieved

Example response

{
  "data": [
    {
      "id": "435834",
      "relationships": {
        "lists": [
          {
            "id": "company_123",
            "type": "list"
          }
        ]
      },
      "type": "contact"
    }
  ],
  "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