---
title: "List emails"
method: GET
path: "/v1/design_studio/emails"
tags: ["Design Studio"]
---

# List emails

`GET /v1/design_studio/emails`

Returns a paginated list of emails and a separate array of folders that the emails belong to.

## Query parameters

- `page` integer
- `limit` integer
- `parent_folder_id` string, uuid
- `direct_descendants_only` boolean
- `sort_by` 'created' | 'updated' | 'name'
- `sort_order` 'asc' | 'desc'
- `created_before` integer
- `created_after` integer
- `updated_before` integer
- `updated_after` integer
- `is_template` 'true' | 'false' | 'any'
- `has_translations` 'true' | 'false' | 'any'
- `is_linked` 'true' | 'false' | 'any'

## Response `200`

Successful response

- object
  - `emails` EmailSummary[]
    - `id` string, uuid — ID of email
    - `name` string — The name of the email
    - `is_template` boolean — Whether the email is a template
    - `is_linked` boolean — Whether the email is linked to a workflow (automation, broadcast, etc)
    - `has_translations` boolean — Whether the email has translations
    - `parent_folder_id` string, uuid, nullable — The ID of the parent folder. Returns `null` if there is no parent, which means the folder is in the root directory.
    - `created` integer — Timestamp of when the email was created.
    - `updated` integer — Timestamp of last update to the email.
  - `folders` Folder[]
    - `id` string, uuid — ID of folder
    - `name` string — The name of the folder.
    - `parent_folder_id` string, uuid, nullable — The ID of the parent folder. Returns `null` if there is no parent, which means the folder is in the root directory.
    - `created` integer — Timestamp of when the folder was created.
    - `updated` integer — Timestamp of last update to the folder.
  - `meta` ListMeta
    - `pagination` object
      - `page` integer — The page number of results you're on.
      - `limit` integer — The number of results per page.
      - `total` integer — The total number of folders.
    - `filters` object — The filters applied in your request.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found

---

[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/4b391af7cb06/schema)