API Documentation

Access NAV data for 12,000+ Indian mutual funds via a simple REST API.

REST APIJSON responsesUpdated dailyAMFI sourced

Quick Start

curl -H "x-api-key: YOUR_API_KEY" \
  "https://getmfdata.com/api/search?q=hdfc+midcap"

Authentication

All endpoints (except /api/health) require an API key sent via the x-api-key header.

x-api-key: YOUR_API_KEY

Don't have an API key? Request access below.

Rate Limits

TierRate LimitPrice

Free10 requests / minuteFree

Pro Coming soon1,000 requests / minuteTBD

Rate limit headers are included in every response: X-RateLimit-Remaining

Error Handling

All responses follow a consistent format:

// Success
{ "data": { ... }, "error": null }

// Error
{ "data": null, "error": "Error message" }

StatusMeaning

200Success

400Bad request (invalid params)

401Unauthorized (missing/invalid API key)

404Fund not found

429Rate limit exceeded

500Server error

Endpoints

GET/api/search

Search Funds

Search mutual funds by name. Returns up to 20 results with latest NAV.

ParameterTypeRequiredDescription

qstringYesSearch query (min 2 chars). Fund name, AMC, or category.

plan_typestringNoFilter by plan: "Direct" or "Regular"

option_typestringNoFilter by option: "Growth", "IDCW", "Dividend", "Bonus"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://getmfdata.com/api/search?q=parag+parikh&plan_type=Direct&option_type=Growth"

Example response

{
  "data": [
    {
      "scheme_code": 122639,
      "isin_growth": "INF879O01027",
      "fund_name": "Parag Parikh Flexi Cap Fund - Direct Plan - Growth",
      "base_fund_name": "Parag Parikh Flexi Cap Fund",
      "plan_type": "Direct",
      "option_type": "Growth",
      "amc": "PPFAS Mutual Fund",
      "scheme_category": "Equity Scheme - Flexi Cap Fund",
      "scheme_type": "Open Ended Schemes",
      "nav": 87.0006,
      "nav_date": "2026-03-24",
      "rank": 0.099
    }
  ],
  "error": null
}

GET/api/nav

Get NAV

Look up the latest NAV for a specific fund by AMFI code or ISIN.

ParameterTypeRequiredDescription

amfi_codenumberNoAMFI scheme code (e.g. 122639)

isinstringNoISIN growth code (e.g. INF879O01027)

curl -H "x-api-key: YOUR_API_KEY" \
  "https://getmfdata.com/api/nav?amfi_code=122639"

Example response

{
  "data": {
    "scheme_code": 122639,
    "isin_growth": "INF879O01027",
    "fund_name": "Parag Parikh Flexi Cap Fund - Direct Plan - Growth",
    "base_fund_name": "Parag Parikh Flexi Cap Fund",
    "plan_type": "Direct",
    "option_type": "Growth",
    "amc": "PPFAS Mutual Fund",
    "scheme_category": "Equity Scheme - Flexi Cap Fund",
    "scheme_type": "Open Ended Schemes",
    "nav": 87.0006,
    "nav_date": "2026-03-24",
    "source": "amfi",
    "last_updated": "2026-03-25T03:00:47.108Z"
  },
  "error": null
}

GET/api/funds/:schemeCode

Get Fund Details

Get full details for a fund by its AMFI scheme code, including NAV.

ParameterTypeRequiredDescription

schemeCodenumberYesAMFI scheme code (path parameter)

curl -H "x-api-key: YOUR_API_KEY" \
  "https://getmfdata.com/api/funds/122639"

Example response

{
  "data": {
    "scheme_code": 122639,
    "isin_growth": "INF879O01027",
    "fund_name": "Parag Parikh Flexi Cap Fund - Direct Plan - Growth",
    "amc": "PPFAS Mutual Fund",
    "scheme_category": "Equity Scheme - Flexi Cap Fund",
    "nav": 87.0006,
    "nav_date": "2026-03-24",
    "source": "amfi"
  },
  "error": null
}

POST/api/nav/bulk

Bulk NAV Lookup

Fetch NAVs for up to 100 funds in a single request. Returns a keyed map for O(1) client-side lookup.

ParameterTypeRequiredDescription

amfi_codesstring[]YesArray of AMFI scheme codes (max 100)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amfi_codes": ["122639", "119551", "999999"]}' \
  "https://getmfdata.com/api/nav/bulk"

Example response

{
  "data": {
    "122639": {
      "nav": 87.0006,
      "nav_date": "2026-03-24",
      "fund_name": "Parag Parikh Flexi Cap Fund - Direct Plan - Growth"
    },
    "119551": {
      "nav": 103.9816,
      "nav_date": "2026-03-24",
      "fund_name": "Aditya Birla Sun Life Banking & PSU Debt Fund - DIRECT - IDCW"
    },
    "999999": null
  },
  "error": null
}

GET/api/healthNo auth required

Health Check

Check API status, data freshness, and total fund count. No authentication required.

curl "https://getmfdata.com/api/health"

Example response

{
  "status": "ok",
  "lastUpdate": "2026-03-25T03:00:47.108Z",
  "lastNavDate": "2026-03-24",
  "totalFunds": 11949,
  "timestamp": "2026-03-25T13:00:00.000Z"
}

Data Source

All NAV data is sourced from AMFI India (amfiindia.com)
Data is refreshed twice daily: 7:00 PM IST and 8:30 AM IST
Covers 12,000+ active schemes across all Indian AMCs
Includes Open Ended, Close Ended, and Interval schemes

Get Your API Key

Get a free API key instantly. Just verify your email.