---
title: "Get a list"
method: GET
path: "/v3/lists/{list_id}"
tags: ["Lists"]
---

# Get a list

`GET /v3/lists/{list_id}`

Returns the specified list.

## Response `200`

OK

- object
  - `request_id` string — ID of the request.
  - `data` ListObject
    - `id` string — Globally unique identifier for the list (UUID).
    - `name` string — A human-readable name for the list. 1–256 characters. Required on create.
    - `description` string — An optional description of the list's purpose.
    - `type` 'domain' | 'tld' | 'address' — The kind of values the list holds and which rule condition fields it can be used with. Required on create and immutable after creation. `domain` holds domain names (matched against `from.domain` or `recipient.domain`), `tld` holds top-level domains (matched against `from.tld` or `recipient.tld`), and `address` holds full email addresses (matched against `from.address` or `recipient.address`).
    - `items_count` integer — The number of items currently in the list. Read-only; maintained by the system.
    - `application_id` string — The ID of the application that owns the list. Read-only; derived from the authenticated API key.
    - `organization_id` string — The ID of the Nylas organization that owns the list. Read-only; derived from the authenticated API key.
    - `created_at` integer — When the list was created, in seconds using the Unix timestamp format.
    - `updated_at` integer — When the list was last updated, in seconds using the Unix timestamp format.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)