AMFI — mutual fund scheme & NAV
tip
Status: LIVE — Real-time data from the upstream regulator. Updated on the regulator's publication cadence.
What it does
AMFI publishes daily NAV files, scheme details, and AMC mappings for every Indian mutual fund. Our API normalizes their daily text dumps into a queryable JSON surface with consistent scheme codes, ISIN cross-references, and historical NAV time-series.
Base URL
https://amfi-mf.sahayakonline.co.in/v1/
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /health | Liveness probe |
GET | /v1/amfi/scheme/{scheme_code} | Scheme metadata + latest NAV |
GET | /v1/amfi/scheme/{scheme_code}/nav | Historical NAV time-series with optional from/to params |
GET | /v1/amfi/amc/{amc_id}/schemes | All schemes under a single AMC |
GET | /v1/amfi/search?q=<query> | Free-text search over scheme name + AMC |
Sample request
- cURL
- Python
- Node.js
curl -sS https://amfi-mf.sahayakonline.co.in/v1/amfi/scheme/119551 \
-H "Authorization: Bearer $SAHAYAK_KEY" \
-H "Accept: application/json"
import os, requests
resp = requests.get(
"https://amfi-mf.sahayakonline.co.in/v1/amfi/scheme/119551",
headers={"Authorization": f"Bearer {os.environ['SAHAYAK_KEY']}", "Accept": "application/json"},
timeout=10,
)
resp.raise_for_status()
print(resp.json())
const fetch = (await import('node-fetch')).default;
const resp = await fetch('https://amfi-mf.sahayakonline.co.in/v1/amfi/scheme/119551', {
headers: {
'Authorization': `Bearer ${process.env.SAHAYAK_KEY}`,
'Accept': 'application/json',
},
});
console.log(await resp.json());
Sample response
{
"spec_ref": "spec_V3_03_AMFI_Mutual_Fund_Scheme_and_NAV_API",
"endpoint": "/v1/amfi/scheme/119551",
"method": "GET",
"results": [
{
"scheme_code": "119551",
"scheme_name": "Parag Parikh Flexi Cap Fund - Direct - Growth",
"amc": "PPFAS Mutual Fund",
"category": "Equity - Flexi Cap",
"isin_growth": "INF879O01019",
"latest_nav": 78.4321,
"nav_date": "2026-05-06"
}
],
"meta": { "fixture_mode": false, "url": "https://amfi-mf.sahayakonline.co.in/v1/" }
}
Error codes
| Code | Meaning | Recommended action |
|---|---|---|
400 | Malformed request (missing required param, invalid format) | Fix request shape. Response body includes error.field pinpointing the issue. |
401 | Missing or invalid Authorization header | Verify key prefix matches your tier and that the header is Authorization: Bearer …. |
403 | Key valid but not entitled to this endpoint | Sandbox keys cannot call live-tier endpoints. Upgrade or request entitlement. |
404 | Resource not found | Check identifier format. Some endpoints return 200 with empty results[] instead of 404 — verify the endpoint convention. |
429 | Rate limit exceeded | Honor Retry-After header. Sandbox 30 r/m, Starter 300 r/m, Growth 1500 r/m. |
503 | Upstream regulator unreachable after retries | Live-tier only. Sahayak retries 3× with backoff before surfacing. Implement circuit-breaker on caller side. |
Rate limits
| Tier | Rate limit | Monthly cap |
|---|---|---|
| Sandbox | 30 r/min | 1,000 live calls (shared across 3 LIVE endpoints) |
| Starter | 300 r/min | 10,000 live calls |
| Growth | 1,500 r/min | 100,000 live calls |
| Scale | custom | 500,000+ |
SLA reference
See Status & SLA for uptime targets, latency targets, and incident communication. NAV updates land within 90 minutes of AMFI's daily 23:00 IST publication.