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

# List Inbound Emails

`GET /v4/inbound-email`

## Request

- Base URL: `https://api.casparser.in`
- URL: `https://api.casparser.in/v4/inbound-email`
- Auth: API key in header `x-api-key`

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.

## Changes

- **2026-09-13** `cf1b57c0f2f7`: 1 warning
  - the optional response header `X-Request-ID` removed for the status `401`
- **2026-07-12** `c74b9ecd5b53`: 1 warning
  - added the new `failed` enum value to the `status` response property for the response status `401`
- **2026-04-20** `78ef474b9e17`: 1 breaking
  - the response property `inbound_emails/items/callback_url` became nullable for the status `200`
- **2026-02-23** `e6762e83ef7c`: 1 info
  - endpoint added
- **2026-02-23** `6a9d3b677dcf`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/changes/v4/inbound-email/get.md)

---

[API](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2.md) - [All operations](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/llms.txt) - [OpenAPI document](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/revisions/9d8f1445bad3?raw)
