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

# List Inbound Emails

`GET /v4/inbound-email`

List all inbound emails associated with your API key.
Returns active and paused inbound emails (deleted ones are excluded).

## Query parameters

- `status` 'active' | 'paused' | 'all'
- `limit` integer
- `offset` integer

## Response `200`

List of inbound emails

- object
  - `status` string
  - `inbound_emails` InboundEmail[]
    - `inbound_email_id` string — Unique inbound email identifier
    - `email` string, email — The inbound email address to forward CAS statements to
    - `reference` string, nullable — Your internal reference identifier
    - `callback_url` string, uri — Webhook URL for email notifications. If set, we POST each parsed email here. If omitted, files are only retrievable via `GET /v4/inbound-email/{id}/files`.
    - `allowed_sources` string[] — Accepted CAS providers (empty = all)
    - `status` 'active' | 'paused' — Current inbound email lifecycle status
    - `metadata` object — Custom key-value metadata
    - `created_at` string, date-time — When the inbound email was created
    - `updated_at` string, date-time — When the inbound email was last updated
  - `total` integer — Total number of inbound emails (for pagination)
  - `limit` integer
  - `offset` integer

## Other responses

- `401` — Unauthorized. This can happen if the `x-api-key` header is missing.

---

[API](https://skmtc.net/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2.md) · [All operations](https://skmtc.net/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casparser/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/revisions/c9918aebb2de/schema)