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

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "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"
    }
}

Modified at 2026-04-14 13:35:01

Create a List

Update List