API reference / Wealth / MF

MF scheme master

Scheme metadata (AMC, category, ISIN).

GET/v1/mf/scheme-master
Authentication
Bearer token
Scope
mf:read

Before you integrate

  • This reply has no balance_minor. An unknown scheme_code returns NOT_FOUND.

Query parameters

FieldTypeRequiredDescription
scheme_codestringYesThe mutual-fund scheme code published by AMFI, for example 120503.

Sample code

Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.

curl -sS -X GET 'https://grappi.ai/v1/mf/scheme-master?scheme_code=120503' \
  -H "Authorization: Bearer $GRAPPI_API_KEY"

Sample response

{
  "request_id": "req_01HZY3K8M2",
  "result": {
    "scheme_code": "120503",
    "scheme_name": "Sample Flexi Cap Fund - Direct - Growth",
    "amc": "Sample Mutual Fund",
    "category": "equity",
    "isin": "INF123K01014"
  }
}

Response fields

FieldTypeDescription
scheme_codestringThe scheme code.
scheme_namestringFull scheme name.
amcstringFund house.
categorystringequity, debt or hybrid.
isinstringScheme ISIN; null if there is none.

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.