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.

INFO

Requires the lists:read OAuth2 scope.

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

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429Server Error

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-08-31 12:06:53

Create Batch Add to List Job

Get Batch Add to List Job