---
title: "List Files Received"
method: GET
path: "/v4/inbound-email/{inbound_email_id}/files"
tags: ["Inbound Email"]
---

# List Files Received

`GET /v4/inbound-email/{inbound_email_id}/files`

Retrieve CAS files forwarded to this inbound email. Available for every
inbound email, regardless of whether a `callback_url` was set — use it
to avoid building a webhook consumer, to poll alongside a webhook, or
to replay missed webhook deliveries.

Pass the `cursor` from the previous response as `since` to receive only
new files.

## Path parameters

- `inbound_email_id` string, required

## Query parameters

- `since` string, date-time
- `limit` integer

## Response `200`

Files received at this inbound email since the cursor

- object
  - `count` integer
  - `cursor` string, date-time, nullable — Pass as `since` on the next poll. `null` if no files and no prior cursor.
  - `files` ReceivedEmailCASFile[] — Files received (sorted oldest-first)
    - `cas_type` 'cdsl' | 'nsdl' | 'cams' | 'kfintech' — Detected CAS provider based on sender email
    - `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)
    - `filename` string — Standardized filename (provider_YYYYMMDD_uniqueid.pdf)
    - `message_date` string, date — Date the email was received
    - `message_id` string — Unique identifier for the email message (use for subsequent API calls)
    - `original_filename` string — Original attachment filename from the 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)
    - `received_at` string, date-time — ISO 8601 timestamp (microsecond precision) when the file was persisted. Use as the `since` cursor on subsequent polls.
  - `status` string

## Other responses

- `400` — Malformed query parameters
- `401` — Unauthorized. This can happen if the `x-api-key` header is missing.
- `404` — Inbound email not found or expired

---

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