API reference / CAS (portfolio fetch)
3.1 CAS Auto Request: one request
The state of one statement request by its id.
GET
/v1/cas/requests/:id- Authentication
- Bearer token
- Scope
cas:request
Before you integrate
- An unknown id returns NOT_FOUND.
Path parameters
| Field | Type | Description |
|---|---|---|
id | string | The request_id of a statement request. |
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/casrq_1a2b3c4d5e6f7a8b' \ -H "Authorization: Bearer $GRAPPI_API_KEY"
Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"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 |
|---|---|---|
request_id | string | Id of this statement request; use it on the request history calls. |
source | string | Which statement issuer the request went to. |
status | string | submitted when accepted, rejected when refused, session_open or expired otherwise. |
pan | string | The investor's PAN, masked. |
email | string | Where the statement will be e-mailed. |
statement_type | string | summary or detailed. |
period | string | current_fy, previous_fy or specific. |
from_date | string | Start date, DD/MM/YYYY; null unless period is specific. |
to_date | string | End date, DD/MM/YYYY; null unless period is specific. |
rta_code | string | The issuer's own result code, if it sent one. |
message | string | The issuer's reply text, word for word. |
created_at | string | When the request was created, ISO 8601. |
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.