API reference / CAS (portfolio fetch)
3.1 CAS Auto Request: history
Your most recent statement requests and what happened to each.
GET
/v1/cas/requests- Authentication
- Bearer token
- Scope
cas:request
Before you integrate
- A request marked submitted means the issuer accepted it. Delivery of the e-mail is not tracked.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many requests to return, newest first, from 1 to 100. Defaults to 20. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X GET 'https://grappi.ai/v1/cas/requests?limit=20' \ -H "Authorization: Bearer $GRAPPI_API_KEY"
Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"requests": [
{
"request_id": "casrq_1a2b3c4d5e6f7a8b",
"source": "kfintech",
"status": "submitted",
"pan": "******234F",
"email": "asha.rao@example.com",
"statement_type": "detailed",
"period": "current_fy",
"from_date": null,
"to_date": null,
"rta_code": null,
"message": "Your request has been received. The statement will be e-mailed shortly.",
"created_at": "2026-11-06T09:30:00.000Z",
"submitted_at": "2026-11-06T09:30:04.000Z"
}
]
}
}Response fields
| Field | Type | Description |
|---|---|---|
requests | array | Your recent statement requests. |
requests[].request_id | string | Id of this statement request; use it on the request history calls. |
requests[].source | string | Which statement issuer the request went to. |
requests[].status | string | submitted when accepted, rejected when refused, session_open or expired otherwise. |
requests[].pan | string | The investor's PAN, masked. |
requests[].email | string | Where the statement will be e-mailed. |
requests[].statement_type | string | summary or detailed. |
requests[].period | string | current_fy, previous_fy or specific. |
requests[].from_date | string | Start date, DD/MM/YYYY; null unless period is specific. |
requests[].to_date | string | End date, DD/MM/YYYY; null unless period is specific. |
requests[].rta_code | string | The issuer's own result code, if it sent one. |
requests[].message | string | The issuer's reply text, word for word. |
requests[].created_at | string | When the request was created, ISO 8601. |
requests[].submitted_at | string | When the issuer accepted it, ISO 8601; null if it did not. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.