Get List Details

GET

/v1/lists/{id}

Retrieve the details of a specific list using its unique ID.
The response includes the list's attributes, such as its name and scope, along with any related information requested through query parameters. This endpoint is used to fetch the full definition of a list before viewing, updating, or managing its assigned items.

Credit Note: Retrieving list definitions does not consume credits.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.leadfeeder.com/v1/lists/company_123?account_id=123456' \
--header 'X-Api-Key: <api-key>'

Responses

🟢200OK

application/json

Success

Bodyapplication/json

Example

{
    "data": {
        "type": "list",
        "id": "company_123",
        "attributes": {
            "name": "US Prospects",
            "scope": "company",
            "created_at": "2024-12-10T15:57:25Z",
            "updated_at": "2024-11-24T11:50:00Z"
        },
        "relationships": {
            "created_by": {
                "id": "12345",
                "type": "user"
            }
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠429Too Many Requests

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-05-22 11:02:07

Create a List

Update List