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

FieldTypeRequiredDescription
limitintegerNoHow 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

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