---
title: "List received emails"
method: GET
path: "/v1/emails/receiving"
tags: ["Receiving"]
---

# List received emails

`GET /v1/emails/receiving`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/emails/receiving`
- Auth: HTTP bearer

Received emails for the team, newest first, with keyset pagination (after walks older, before walks newer, exclusive). List items carry metadata only; fetch one email for the body. Requires the inbound:read scope.

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `to` string
- `domain_id` string
- `unread` boolean
- `q` string

## Response `200`

Received emails

- object
  - `object` string
  - `has_more` boolean
  - `data` ReceivedEmailSummary[]
    - `object` string
    - `id` string
    - `to` string[]
    - `from` string
    - `created_at` string, date-time
    - `subject` string
    - `bcc` string[]
    - `cc` string[]
    - `reply_to` string[]
    - `received_for` string[]
    - `message_id` string
    - `attachments` ReceivedAttachment[]
      - `id` string
      - `filename` string
      - `content_type` string
      - `content_disposition` 'attachment' | 'inline'
      - `content_id` string, nullable
      - `size` integer
      - `download_url` string, uri: Present on the attachment endpoints; valid for 15 minutes
      - `expires_at` string, date-time
    - `status` 'delivered' | 'quarantined'
    - `envelope_from` string, nullable
    - `envelope_to` string[]
    - `domain_id` string, nullable
    - `size` integer, nullable
    - `verdicts` object
      - `spf` string, nullable
      - `dkim` string, nullable
      - `dmarc` string, nullable
      - `spam` string, nullable
      - `virus` string, nullable
    - `in_reply_to` string, nullable
    - `references` string[]
    - `read_at` string, date-time, nullable: When the message was marked read. Not in Resend.
    - `inbox_id` string, nullable: The inbox this copy was filed into, when its address has one. Not in Resend.
    - `thread_id` string, nullable: The inbox thread this copy was filed into. Not in Resend.
  - `unread_count` integer: Unread emails matching the same to, domain_id and q filters (not in Resend)

## Other responses

- `400`: Bad request - check your payload
- `401`: Invalid or missing API key
- `403`: Forbidden - domain not verified or insufficient permissions
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

[API](https://skmtc.dev/smtpfa/apis/smtpfast-api.md) · [All operations](https://skmtc.dev/smtpfa/apis/smtpfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smtpfa/apis/smtpfast-api/revisions/79dda742f53e?raw)