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

FieldTypeDescription
idstringThe 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

FieldTypeDescription
request_idstringId of this statement request; use it on the request history calls.
sourcestringWhich statement issuer the request went to.
statusstringsubmitted when accepted, rejected when refused, session_open or expired otherwise.
panstringThe investor's PAN, masked.
emailstringWhere the statement will be e-mailed.
statement_typestringsummary or detailed.
periodstringcurrent_fy, previous_fy or specific.
from_datestringStart date, DD/MM/YYYY; null unless period is specific.
to_datestringEnd date, DD/MM/YYYY; null unless period is specific.
rta_codestringThe issuer's own result code, if it sent one.
messagestringThe issuer's reply text, word for word.
created_atstringWhen the request was created, ISO 8601.
submitted_atstringWhen 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.