Retrieve List Items - Leadfeeder API

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.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

List items retrieved

Bodyapplication/json

Examples

Company list — bare company referencesContact list — bare contact references

{
    "data": [
        {
            "type": "company",
            "id": "159001425"
        },
        {
            "type": "company",
            "id": "129011"
        }
    ],
    "meta": {
        "pagination": {
            "total_count": 51,
            "next_cursor": "MzUzNTQxMzEyMQ=="
        },
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout