---
title: "List inbound email"
method: GET
path: "/inbound/email"
tags: ["Inbound"]
---

# List inbound email

`GET /inbound/email`

## Request

- Base URL: `https://api.paidnice.com/rest/v1`
- URL: `https://api.paidnice.com/rest/v1/inbound/email`
- Auth: HTTP bearer

Returns inbound emails for the authenticated organisation, most recent first.

## Query parameters

- `limit` integer: Maximum number of records to return
- `cursor` string: Opaque cursor from a previous response's nextCursor. Omit to start from the most recent record.

## Response `200`

A page of inbound emails

- object
  - `data` InboundEmail[], required
    - `id` string, required
    - `from` string, required
    - `to` string, required
    - `cc` string
    - `subject` string
    - `extractedReplyText` string
    - `attachmentCount` integer, required
    - `createdAt` string, required
    - `contactId` integer
    - `contactName` string
  - `nextCursor` string: Pass as the cursor query parameter to fetch the next page. Absent on the last page.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: The public API is not enabled for the organisation, or the API key lacks the required scope
- `429`: Too many requests

---

[API](https://skmtc.dev/paidnice/apis/paidnice-public-api.md) · [All operations](https://skmtc.dev/paidnice/apis/paidnice-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paidnice/apis/paidnice-public-api/revisions/d4911087b8e7?raw)