---
title: "GET /v1/emails"
method: GET
path: "/v1/emails"
---

# GET /v1/emails

`GET /v1/emails`

## Query parameters

- `page` string
- `limit` string
- `startDate` string, date-time
- `endDate` string, date-time
- `domainId` union
  - string
  - string[]

## Response `200`

Retrieve a list of emails

- object
  - `data` object[], required
    - `id` string, required
    - `to` union, required
      - string
      - string[]
    - `replyTo` union
      - string
      - string[]
      - unknown
    - `cc` union
      - string
      - string[]
      - unknown
    - `bcc` union
      - string
      - string[]
      - unknown
    - `from` string, required
    - `subject` string, required
    - `html` string, nullable, required
    - `text` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `latestStatus` 'SCHEDULED' | 'QUEUED' | 'SENT' | 'DELIVERY_DELAYED' | 'BOUNCED' | 'REJECTED' | 'RENDERING_FAILURE' | 'DELIVERED' | 'OPENED' | 'CLICKED' | 'COMPLAINED' | 'FAILED' | 'CANCELLED' | 'SUPPRESSED', nullable, required
    - `scheduledAt` string, date-time, nullable, required
    - `domainId` number, nullable, required
  - `count` number, required

---

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