---
title: "Get a list of emails"
method: GET
path: "/smtp/emails"
tags: ["Emails"]
---

# Get a list of emails

`GET /smtp/emails`

## Request

- Base URL: `https://api.sendpulse.com`
- URL: `https://api.sendpulse.com/smtp/emails`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (client credentials, token URL `https://api.sendpulse.com/oauth/access_token`)

## Query parameters

- `limit` integer
- `offset` integer
- `from` string, date
- `to` string, date
- `sender` string
- `recipient` string
- `country` string

## Response `200`

List of emails

- EmailRecord[]
  - `id` string
  - `sender` string
  - `total_size` union
    - integer
    - string
  - `sender_ip` string
  - `smtp_answer_code` union
    - integer
    - string
  - `smtp_answer_subcode` string
  - `smtp_answer_data` string
  - `used_ip` string
  - `recipient` string, nullable
  - `subject` string
  - `send_date` string
  - `tracking` object
    - `click` integer
    - `open` integer
    - `link` object[]
    - `client_info` object[]

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation error

---

[API](https://skmtc.dev/sendpulse/apis/sendpulse-smtp-api.md) · [All operations](https://skmtc.dev/sendpulse/apis/sendpulse-smtp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sendpulse/apis/sendpulse-smtp-api/revisions/9bab1dd9ec2e?raw)