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

# List items in a list

`GET /v3/lists/{list_id}/items`

Returns the items in the specified list.

## Query parameters

- `limit` integer
- `page_token` string

## Response `200`

OK

- object
  - `request_id` string — ID of the request.
  - `data` ListItemObject[]
    - `id` string — Globally unique identifier for the list item (UUID).
    - `list_id` string — The ID of the list that contains the item.
    - `value` string — The item's value, normalized (lowercased and trimmed) on write. The format depends on the parent list's `type`: a domain, a top-level domain, or an email address.
    - `created_at` integer — When the item was added to the list, in seconds using the Unix timestamp format.
  - `next_cursor` string — A token to use for paginating through results. If present, pass this value as `page_token` in the next request.

## 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)