---
title: "Get List Details"
method: GET
path: "/v1/lists/{id}"
tags: ["Lists", "v1"]
---

# 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.
:::

## Path parameters

- `id` string, required

## Query parameters

- `account_id` string, required

## Response `200`

Success

- object
  - `data` ListV1, required
    - `type` 'list', required — The type of the object
    - `id` string, required — The unique identifier for the list
    - `attributes` object, required
      - `name` string, required — The human-readable name of the List
      - `scope` 'company' | 'contact', required — The scope type of the list
      - `created_at` string, date-time, required — Date and time when the list was created
      - `updated_at` string, date-time — Date and time when the list was updated
    - `relationships` object, required
      - `created_by` object, required
        - `id` string, required — The Leadfeeder user ID.
        - `type` string, required
  - `meta` object, required
    - `request_id` string, required — A unique identifier assigned to each API request for end-to-end traceability.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. The request was rejected because the credentials are missing, invalid, expired, or have been revoked. The client must re-authenticate before retrying. Clients can differentiate via the `code` value of the first item in `errors`.
- `403` — Forbidden. The credentials are valid but the caller is not authorized to perform the request — typically because the user lacks the required permission, the OAuth scope is insufficient, the subscription plan does not include the required entitlement, the `account_id` does not belong to the authenticated user, or the target list is read-only and its members cannot be modified. Clients can differentiate via the `code` value of the first item in `errors`.
- `404` — Not found
- `429` — Too many requests. Either the per-second rate limit or the monthly quota configured for the API key / OAuth application has been exceeded. Clients can differentiate via the `code` value of the first item in `errors`.
- `500` — Internal server error
- `504` — Server timeout

---

[API](https://skmtc.net/leadfeeder/apis/leadfeeder-public-api.md) · [All operations](https://skmtc.net/leadfeeder/apis/leadfeeder-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadfeeder/leadfeeder-public-api/versions/e494ac05e206/schema)