---
title: "List newsletters"
method: GET
path: "/v1/newsletters"
tags: ["Newsletters"]
---

# List newsletters

`GET /v1/newsletters`

Returns a list of your newsletters and associated metadata.

## Query parameters

- `limit` integer
- `sort` 'asc' | 'desc'
- `start` string

## Response `200`

Returns an array of newsletter objects.

- object
  - `newsletters` NewsletterObject[]
    - `id` integer — The identifier for a newsletter.
    - `deduplicate_id` string — An identifier in the format `id:timestamp` where the id is for the object you're working with (Automations, Deliveries, Exports, Identities, Newsletters, Segments, and Templates), and the timestamp is the last time the object was updated.
    - `content_ids` integer[] — A list of message variants in a newsletter, where a variant is a translation or A/B test.
    - `name` string — The name of the newsletter. Must be 190 characters or less.
    - `sent_at` integer — The last time the newsletter was sent.
    - `created` integer — The date time when the referenced ID was created.
    - `updated` integer — The date time when the referenced ID was last updated.
    - `type` 'email' | 'webhook' | 'twilio' | 'push' | 'in_app' | 'inbox' — Channel type for a newsletter or newsletter content variant.
    - `tags` string[] — An array of tags associated with the newsletter.
    - `recipient_segment_ids` integer[] — If the recipient conditions included segments, this returns a list of those segment ids.
    - `subscription_topic_id` integer — If you enabled a [subscription center](/journeys/channels/subscriptions/center/) on your workspace, this returns the id of the subscription preference you set.
  - `next` string — Indicates the next page of results. Add `?start=<next_value>` to the request to get the next page of results.

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/00b93971a49f/schema)