eCAS

Upload eCAS PDF

Upload an eCAS PDF with its password. Returns the parsed extraction session including investor details, demat holdings, and mutual fund holdings.

POST

Authorizations

Authorization

stringrequired

Bearer access token from login (Authorization: Bearer <token>).

Upload an eCAS PDF and receive a structured extraction session. Source docs: ecas_upload_create.

No query or path parameters.

Body

multipart/form-data

pdfstring ($binary)required

eCAS PDF file to upload and parse.

passwordstringrequired

Password for the PDF (typically the investor PAN).

Response

201application/json

idinteger

Extraction session id.

sourcestring

Statement source / depository label.

investor_namestring

Investor name from the eCAS.

panstring

Investor PAN.

period_fromstring

Statement period start.

period_tostring

Statement period end.

total_portfolio_valuenumber

Total portfolio value.

created_atstring (date-time)

When the session was created.

updated_atstring (date-time)

When the session was last updated.

holdingsarray

idinteger

Holding row id.

depositorystring

Depository name (e.g. CDSL / NSDL).

dp_namestring

Depository participant name.

dp_idstring

DP id.

client_idstring

Client id.

bo_idstring

Beneficiary owner id.

isinstring

Security ISIN.

security_namestring

Security name.

symbolstring

Trading symbol when available.

asset_typestring

Asset classification.

quantitynumber

Total quantity.

pledged_quantitynumber

Pledged quantity.

free_quantitynumber

Free (unpledged) quantity.

face_valuenumber

Face value.

market_pricenumber

Market price.

valuenumber

Holding market value.

mf_holdingsarray

idinteger

Mutual fund holding id.

isinstring

Scheme ISIN.

scheme_namestring

Scheme name.

amc_namestring

AMC name.

folio_nostring

Folio number.

unitsnumber

Units held.

navnumber

Net asset value.

valuenumber

Current value.

investednumber

Invested amount.

Responses

Code	Description
201	Created — extraction session JSON
400	Bad request (invalid PDF/password)
401	Unauthorized

Upload eCAS PDF

curl -X POST https://kniwealthtech.ai/api/v1/ecas/upload/ \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "[email protected]" \
  -F "password=YOUR_PAN_OR_PDF_PASSWORD"

{
  "id": 0,
  "source": "string",
  "investor_name": "string",
  "pan": "string",
  "period_from": "string",
  "period_to": "string",
  "total_portfolio_value": 0,
  "created_at": "2026-07-24T10:35:53.207Z",
  "updated_at": "2026-07-24T10:35:53.207Z",
  "holdings": [
    {
      "id": 0,
      "depository": "string",
      "dp_name": "string",
      "dp_id": "string",
      "client_id": "string",
      "bo_id": "string",
      "isin": "string",
      "security_name": "string",
      "symbol": "string",
      "asset_type": "string",
      "quantity": 0,
      "pledged_quantity": 0,
      "free_quantity": 0,
      "face_value": 0,
      "market_price": 0,
      "value": 0
    }
  ],
  "mf_holdings": [
    {
      "id": 0,
      "isin": "string",
      "scheme_name": "string",
      "amc_name": "string",
      "folio_no": "string",
      "units": 0,
      "nav": 0,
      "value": 0,
      "invested": 0
    }
  ]
}