---
title: "List CAS Files from Email Inbox"
method: POST
path: "/v4/inbox/cas"
tags: ["Email Import"]
---

# List CAS Files from Email Inbox

`POST /v4/inbox/cas`

## Request

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

Search the user's email inbox for CAS files from known senders
(CAMS, KFintech, CDSL, NSDL).

Files are uploaded to temporary cloud storage. **URLs expire in 24 hours.**

Optionally filter by CAS provider and date range.

**Billing:** 0.2 credits per request (charged regardless of success or number of files found).

## Headers

- `x-inbox-token` string, required

## Request body

- object
  - `start_date` string, date: Start date in ISO format (YYYY-MM-DD). Defaults to 30 days ago.
  - `end_date` string, date: End date in ISO format (YYYY-MM-DD). Defaults to today.
  - `cas_types` string[]: Filter by CAS provider(s): - `cdsl` → eCAS@cdslstatement.com - `nsdl` → NSDL-CAS@nsdl.co.in - `cams` → donotreply@camsonline.com - `kfintech` → samfS@kfintech.com

## Response `200`

CAS files found in inbox

- object
  - `status` string
  - `files` EmailCASFile[]
    - `message_id` string: Unique identifier for the email message (use for subsequent API calls)
    - `filename` string: Standardized filename (provider_YYYYMMDD_uniqueid.pdf)
    - `original_filename` string: Original attachment filename from the email
    - `message_date` string, date: Date the email was received
    - `cas_type` 'cdsl' | 'nsdl' | 'cams' | 'kfintech': Detected CAS provider based on sender email
    - `sender_email` string, email: Email address of the CAS authority (CDSL, NSDL, CAMS, or KFintech) who originally sent this statement
    - `size` integer: File size in bytes
    - `url` string, uri: Direct download URL (presigned, expires based on expires_in)
    - `expires_in` integer: URL expiration time in seconds. Defaults vary by source: - Email Inbox Import (Gmail, Outlook, Zoho): 86400 (24h) - Inbound Email with `callback_url` set: 172800 (48h) - Inbound Email without `callback_url`: aligned with the session TTL (~30 min)
  - `count` integer: Number of CAS files found

## Other responses

- `401`: Token invalid or revoked
- `500`: Internal server error

## Changes

- **2026-09-13** `cf1b57c0f2f7`: 1 warning
  - the optional response header `X-Request-ID` removed for the status `500`
- **2026-02-23** `e6762e83ef7c`: 1 info
  - added the optional property `files/items/sender_email` to the response with the `200` status
- **2026-02-23** `6a9d3b677dcf`: 1 warning
  - removed the optional property `files/items/sender_email` from the response with the `200` status
- **2026-02-23** `40b4066344aa`: 1 info
  - added the optional property `files/items/sender_email` to the response with the `200` status
- **2026-02-14** `ce2296c4b14d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casparser/apis/cas-parser-track-portfolios-from-cdsl-nsdl-cams-kfintech-2/changes/v4/inbox/cas/post.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)
