Retrieve List Items
Retrieve the members of a list. The list is addressed by its {id}, a scope-prefixed list identifier (e.g. company_123 or contact_456). There is a single List resource: the list's list_type determines whether the members are companies or contacts.
The response contains bare references (IDs only) in data, with type following the list's list_type (company for a company list, contact for a contact list). Results are cursor-paginated. To retrieve the full company or contact data for these members, pass the returned IDs to the Retrieve Companies (GET /v1/companies) or Retrieve Contacts (GET /v1/contacts) endpoints.
Credit Note: Retrieving list members does not consume credits.
:::info Requires the lists:read OAuth2 scope. :::
Path parameters
Unique identifier of the list (e.g. company_123)
Query parameters
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
Cursor for pagination. Use this value to fetch the next page of results.
The number of items per page. Maximum is 100.
Response
List items retrieved
Example response
{
"data": [
{
"id": "129011"
}
],
"meta": {
"pagination": {
"total_count": 51,
"next_cursor": "MzUzNTQxMzEyMQ=="
},
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}