---
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`

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

---

[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)