### List Schemes with Pagination (GET Request) Source: https://www.mfapi.in/docs This example demonstrates how to retrieve a paginated list of all mutual fund schemes. It uses the '/mf' endpoint with 'limit' and 'offset' query parameters to control the number of results and the starting point. ```http GET https://api.mfapi.in/mf?limit=100&offset=0 ``` -------------------------------- ### Search for Mutual Fund Schemes (GET Request) Source: https://www.mfapi.in/docs This example shows how to search for mutual fund schemes by name using a GET request to the '/mf/search' endpoint. The 'q' parameter is used to specify the search query. ```http GET https://api.mfapi.in/mf/search?q=HDFC ``` -------------------------------- ### Latest NAV Response Example (JSON) Source: https://www.mfapi.in/docs This is an example of the JSON response structure when requesting the latest Net Asset Value (NAV) for a mutual fund scheme. It includes metadata about the fund and the latest NAV data. ```json { "meta": { "fund_house": "HDFC Mutual Fund", "scheme_type": "Open Ended Schemes", "scheme_category": "Equity Scheme - Large Cap Fund", "scheme_code": 125497, "scheme_name": "HDFC Top 100 Fund - Direct Plan - Growth", "isin_growth": "INF179K01BB2", "isin_div_reinvestment": null }, "data": [ { "date": "26-10-2024", "nav": "892.45600" } ], "status": "SUCCESS" } ``` -------------------------------- ### Get NAV History for a Scheme Source: https://www.mfapi.in/docs/openapi Retrieve historical NAV data for a specific mutual fund scheme within a date range. You can specify start and end dates to filter the results. ```APIDOC ## GET /mf/{scheme_code} ### Description Retrieve historical NAV data for a specific mutual fund scheme within a date range. ### Method GET ### Endpoint /mf/{scheme_code} ### Parameters #### Path Parameters - **scheme_code** (integer) - Required - Unique scheme code #### Query Parameters - **startDate** (string) - Optional - Start date for NAV history (ISO 8601 format, e.g., YYYY-MM-DD) - **endDate** (string) - Optional - End date for NAV history (ISO 8601 format, e.g., YYYY-MM-DD) ### Request Example ```json { "example": "/mf/125497?startDate=2023-01-01&endDate=2023-12-31" } ``` ### Response #### Success Response (200) - **nav** (number) - The Net Asset Value for the given date. - **date** (string) - The date of the NAV value (ISO 8601 format). #### Response Example ```json { "example": [ { "nav": 10.50, "date": "2023-01-01" }, { "nav": 10.55, "date": "2023-01-02" } ] } ``` ``` -------------------------------- ### Get Latest NAV Source: https://www.mfapi.in/docs/openapi Retrieves the latest Net Asset Value (NAV) for a given mutual fund scheme. ```APIDOC ## GET /schemes/latest-nav ### Description Retrieves the latest Net Asset Value (NAV) for multiple mutual fund schemes. ### Method GET ### Endpoint /schemes/latest-nav ### Parameters #### Query Parameters - **schemeCodes** (string) - Required - Comma-separated list of scheme codes for which to retrieve the latest NAV. ### Response #### Success Response (200) - **schemeCode** (integer) - Unique identifier for the scheme. - **schemeName** (string) - Full name of the mutual fund scheme. - **fundHouse** (string) - Name of the fund house. - **schemeType** (string) - Type of the scheme. - **schemeCategory** (string) - Category of the scheme. - **isinGrowth** (string) - ISIN code for growth option (nullable). - **isinDivReinvestment** (string) - ISIN code for dividend reinvestment option (nullable). - **nav** (string) - Latest Net Asset Value with 5 decimal precision. - **date** (string) - NAV date in DD-MM-YYYY format. #### Response Example [ { "schemeCode": 100001, "schemeName": "ICICI Prudential Bluechip Fund", "fundHouse": "ICICI Prudential AMC", "schemeType": "Open Ended Schemes", "schemeCategory": "Equity", "isinGrowth": "INF109K01029", "isinDivReinvestment": "INF109K01128", "nav": "10.60000", "date": "03-01-2023" }, { "schemeCode": 100002, "schemeName": "HDFC Mid-Cap Opportunities Fund", "fundHouse": "HDFC AMC", "schemeType": "Open Ended Schemes", "schemeCategory": "Equity", "isinGrowth": "INF176F01020", "isinDivReinvestment": "INF176F01129", "nav": "15.20000", "date": "03-01-2023" } ] ``` -------------------------------- ### GET /mf/latest Source: https://www.mfapi.in/docs/openapi Retrieve the most recent NAV data for all mutual fund schemes. This endpoint returns a complete dataset from the cache, providing the latest NAV for every scheme. ```APIDOC ## GET /mf/latest ### Description Retrieve the most recent NAV data for all mutual fund schemes. This endpoint returns a complete dataset from the cache, providing the latest NAV for every scheme. ### Method GET ### Endpoint /mf/latest ### Parameters None ### Request Example ```json { "example": "GET /mf/latest" } ``` ### Response #### Success Response (200) - **(array)** - An array of objects, where each object represents the latest NAV data for a scheme, including 'schemeCode', 'schemeName', 'fundHouse', 'schemeType', 'schemeCategory', 'isinGrowth', 'isinDivReinvestment', 'nav', and 'date'. #### Response Example ```json { "example": [ { "schemeCode": 125497, "schemeName": "HDFC Balanced Advantage Fund - Direct Plan - Growth", "fundHouse": "HDFC Mutual Fund", "schemeType": "Open Ended Schemes", "schemeCategory": "Balanced Advantage Fund", "isinGrowth": "INF179K01BB2", "isinDivReinvestment": "INF179K01BC0", "nav": "48.56700", "date": "26-10-2024" }, { "schemeCode": 100119, "schemeName": "HDFC Banking and PSU Debt Fund - Direct Plan - Growth", "fundHouse": "HDFC Mutual Fund", "schemeType": "Open Ended Schemes", "schemeCategory": "Debt Scheme - Banking and PSU Fund", "isinGrowth": "INF179K01XY9", "isinDivReinvestment": null, "nav": "15.23400", "date": "26-10-2024" } ] } ``` ``` -------------------------------- ### Search Response Example (JSON) Source: https://www.mfapi.in/docs This JSON structure represents the response when searching for mutual fund schemes. It returns an array of objects, each containing the 'schemeCode' and 'schemeName'. ```json [ { "schemeCode": 125497, "schemeName": "HDFC Top 100 Fund - Direct Plan - Growth" }, { "schemeCode": 125498, "schemeName": "HDFC Top 100 Fund - Regular Plan - Growth" } ] ``` -------------------------------- ### Get Scheme Details Source: https://www.mfapi.in/docs/openapi Retrieves detailed information about a specific mutual fund scheme, including its type, category, and ISIN codes. ```APIDOC ## GET /schemes/{schemeCode} ### Description Retrieves detailed information about a specific mutual fund scheme using its unique code. ### Method GET ### Endpoint /schemes/{schemeCode} ### Parameters #### Path Parameters - **schemeCode** (integer) - Required - The unique identifier for the scheme. ### Response #### Success Response (200) - **schemeCode** (integer) - Unique identifier for the scheme. - **schemeName** (string) - Full name of the mutual fund scheme. - **fund_house** (string) - Name of the fund house. - **scheme_type** (string) - Type of the scheme (e.g., Open Ended Schemes). - **scheme_category** (string) - Category of the scheme. - **isin_growth** (string) - ISIN code for growth option (nullable). - **isin_div_reinvestment** (string) - ISIN code for dividend reinvestment option (nullable). #### Response Example { "schemeCode": 100001, "schemeName": "ICICI Prudential Bluechip Fund", "fund_house": "ICICI Prudential AMC", "scheme_type": "Open Ended Schemes", "scheme_category": "Equity", "isin_growth": "INF109K01029", "isin_div_reinvestment": "INF109K01128" } ``` -------------------------------- ### List All Mutual Fund Schemes Source: https://www.mfapi.in/docs/openapi Get a paginated list of all available mutual fund schemes with ISIN codes. This endpoint is useful for retrieving a comprehensive list of funds. ```APIDOC ## GET /mf ### Description Get a paginated list of all available mutual fund schemes with ISIN codes. ### Method GET ### Endpoint /mf ### Parameters #### Query Parameters - **limit** (integer) - Optional - Number of results to return (max 1000) - **offset** (integer) - Optional - Number of results to skip for pagination (default 0) ### Request Example ```json { "example": "?limit=100&offset=0" } ``` ### Response #### Success Response (200) - **schemeCode** (integer) - The unique code for the mutual fund scheme. - **schemeName** (string) - The name of the mutual fund scheme. - **isinGrowth** (string) - The ISIN for the growth option of the scheme. - **isinDivReinvestment** (string) - The ISIN for the dividend reinvestment option of the scheme. #### Response Example ```json { "example": [ { "schemeCode": 100119, "schemeName": "HDFC Balanced Advantage Fund - Direct Plan - Growth", "isinGrowth": "INF179K01BB2", "isinDivReinvestment": "INF179K01BC0" } ] } ``` ``` -------------------------------- ### Get Scheme NAV History with Date Range (GET Request) Source: https://www.mfapi.in/docs This snippet illustrates how to fetch the Net Asset Value (NAV) history for a specific mutual fund scheme within a given date range. It utilizes the '/mf/{scheme_code}' endpoint with 'startDate' and 'endDate' query parameters. ```http GET https://api.mfapi.in/mf/125497?startDate=2023-01-01&endDate=2023-12-31 ``` -------------------------------- ### GET /mf/{scheme_code}/latest Source: https://www.mfapi.in/docs/openapi Retrieve the most recent NAV data for a specific mutual fund scheme. This endpoint is useful for quickly accessing the latest available NAV information. ```APIDOC ## GET /mf/{scheme_code}/latest ### Description Retrieve the most recent NAV data for a specific mutual fund scheme. This endpoint is useful for quickly accessing the latest available NAV information. ### Method GET ### Endpoint /mf/{scheme_code}/latest ### Parameters #### Path Parameters - **scheme_code** (integer) - Required - Unique scheme code ### Request Example ```json { "example": "GET /mf/125497/latest" } ``` ### Response #### Success Response (200) - **meta** (object) - Metadata about the fund scheme. - **data** (array) - An array containing the latest NAV data point, with 'date' and 'nav'. - **status** (string) - Indicates the status of the request (e.g., "SUCCESS"). #### Response Example ```json { "example": { "meta": { "fund_house": "HDFC Mutual Fund", "scheme_type": "Open Ended Schemes", "scheme_category": "Balanced Advantage Fund", "scheme_code": 125497, "scheme_name": "HDFC Balanced Advantage Fund - Direct Plan - Growth", "isin_growth": "INF179K01BB2", "isin_div_reinvestment": "INF179K01BC0" }, "data": [ { "date": "26-10-2024", "nav": "48.56700" } ], "status": "SUCCESS" } } ``` ``` -------------------------------- ### Get NAV History Source: https://www.mfapi.in/docs/openapi Retrieves the historical Net Asset Value (NAV) data for a given mutual fund scheme over a specified period. ```APIDOC ## GET /schemes/{schemeCode}/nav ### Description Retrieves the historical Net Asset Value (NAV) data for a specific mutual fund scheme. ### Method GET ### Endpoint /schemes/{schemeCode}/nav ### Parameters #### Path Parameters - **schemeCode** (integer) - Required - The unique identifier for the scheme. #### Query Parameters - **startDate** (string) - Optional - Start date for the NAV history in DD-MM-YYYY format. - **endDate** (string) - Optional - End date for the NAV history in DD-MM-YYYY format. ### Response #### Success Response (200) - **meta** (object) - Metadata about the scheme. - **fund_house** (string) - Name of the fund house. - **scheme_type** (string) - Type of the scheme. - **scheme_category** (string) - Category of the scheme. - **scheme_code** (integer) - Unique identifier for the scheme. - **scheme_name** (string) - Full name of the mutual fund scheme. - **isin_growth** (string) - ISIN code for growth option (nullable). - **isin_div_reinvestment** (string) - ISIN code for dividend reinvestment option (nullable). - **data** (array) - Array of NAV data objects. - **date** (string) - Date in DD-MM-YYYY format. - **nav** (string) - Net Asset Value with 5 decimal precision. - **status** (string) - Response status (SUCCESS or ERROR). #### Response Example { "meta": { "fund_house": "ICICI Prudential AMC", "scheme_type": "Open Ended Schemes", "scheme_category": "Equity", "scheme_code": 100001, "scheme_name": "ICICI Prudential Bluechip Fund", "isin_growth": "INF109K01029", "isin_div_reinvestment": "INF109K01128" }, "data": [ { "date": "01-01-2023", "nav": "10.50000" }, { "date": "02-01-2023", "nav": "10.55000" } ], "status": "SUCCESS" } ``` -------------------------------- ### Get Latest NAV for a Specific Scheme Source: https://www.mfapi.in/docs Retrieve the most recent Net Asset Value (NAV) for a specific mutual fund scheme code. ```APIDOC ## GET /mf/{scheme_code}/latest ### Description Get the latest NAV for a specific mutual fund scheme. ### Method GET ### Endpoint `/mf/{scheme_code}/latest` #### Path Parameters - **scheme_code** (integer) - Required - The unique code of the mutual fund scheme. ### Request Example ``` GET https://api.mfapi.in/mf/125497/latest ``` ### Response #### Success Response (200) - **meta** (object) - Metadata about the fund scheme. - **fund_house** (string) - The name of the fund house. - **scheme_type** (string) - The type of the scheme (e.g., 'Open Ended Schemes'). - **scheme_category** (string) - The category of the scheme (e.g., 'Equity Scheme - Large Cap Fund'). - **scheme_code** (integer) - The unique code for the mutual fund scheme. - **scheme_name** (string) - The name of the mutual fund scheme. - **isin_growth** (string) - ISIN for the growth option. - **isin_div_reinvestment** (string) - ISIN for the dividend reinvestment option. - **data** (array) - An array containing the latest NAV data point. - **date** (string) - The date of the NAV in DD-MM-YYYY format. - **nav** (string) - The Net Asset Value for that date. - **status** (string) - The status of the request (e.g., 'SUCCESS'). #### Response Example ```json { "meta": { "fund_house": "HDFC Mutual Fund", "scheme_type": "Open Ended Schemes", "scheme_category": "Equity Scheme - Large Cap Fund", "scheme_code": 125497, "scheme_name": "HDFC Top 100 Fund - Direct Plan - Growth", "isin_growth": "INF179K01BB2", "isin_div_reinvestment": null }, "data": [ { "date": "26-10-2024", "nav": "892.45600" } ], "status": "SUCCESS" } ``` ``` -------------------------------- ### GET /mf/{scheme_code}/history Source: https://www.mfapi.in/docs/openapi Retrieve historical Net Asset Value (NAV) data for a specific mutual fund scheme. This endpoint allows users to fetch NAV data over a specified period. ```APIDOC ## GET /mf/{scheme_code}/history ### Description Retrieve historical Net Asset Value (NAV) data for a specific mutual fund scheme. This endpoint allows users to fetch NAV data over a specified period. ### Method GET ### Endpoint /mf/{scheme_code}/history ### Parameters #### Path Parameters - **scheme_code** (integer) - Required - Unique identifier for the scheme #### Query Parameters - **start_date** (string) - Optional - The start date for fetching NAV history (YYYY-MM-DD). - **end_date** (string) - Optional - The end date for fetching NAV history (YYYY-MM-DD). ### Request Example ```json { "example": "GET /mf/125497/history?start_date=2023-12-01&end_date=2023-12-31" } ``` ### Response #### Success Response (200) - **meta** (object) - Metadata about the fund scheme. - **data** (array) - An array of NAV data points, each containing 'date' and 'nav'. - **status** (string) - Indicates the status of the request (e.g., "SUCCESS"). #### Response Example ```json { "example": { "meta": { "fund_house": "HDFC Mutual Fund", "scheme_type": "Open Ended Schemes", "scheme_category": "Balanced Advantage Fund", "scheme_code": 125497, "scheme_name": "HDFC Balanced Advantage Fund - Direct Plan - Growth", "isin_growth": "INF179K01BB2", "isin_div_reinvestment": "INF179K01BC0" }, "data": [ { "date": "31-12-2023", "nav": "45.12300" }, { "date": "30-12-2023", "nav": "45.00100" } ], "status": "SUCCESS" } } ``` ``` -------------------------------- ### Get NAV History for a Specific Scheme Source: https://www.mfapi.in/docs Retrieve the Net Asset Value (NAV) history for a given mutual fund scheme code. You can specify a date range for the history. ```APIDOC ## GET /mf/{scheme_code} ### Description Get NAV history for a specific mutual fund scheme. ### Method GET ### Endpoint `/mf/{scheme_code}` #### Path Parameters - **scheme_code** (integer) - Required - The unique code of the mutual fund scheme. #### Query Parameters - **startDate** (string) - Optional - The start date for the NAV history in YYYY-MM-DD format. - **endDate** (string) - Optional - The end date for the NAV history in YYYY-MM-DD format. ### Request Example ``` GET https://api.mfapi.in/mf/125497?startDate=2023-01-01&endDate=2023-12-31 ``` ### Response #### Success Response (200) - **meta** (object) - Metadata about the fund scheme. - **fund_house** (string) - The name of the fund house. - **scheme_type** (string) - The type of the scheme (e.g., 'Open Ended Schemes'). - **scheme_category** (string) - The category of the scheme (e.g., 'Equity Scheme - Large Cap Fund'). - **scheme_code** (integer) - The unique code for the mutual fund scheme. - **scheme_name** (string) - The name of the mutual fund scheme. - **isin_growth** (string) - ISIN for the growth option. - **isin_div_reinvestment** (string) - ISIN for the dividend reinvestment option. - **data** (array) - An array of NAV data points. - **date** (string) - The date of the NAV in DD-MM-YYYY format. - **nav** (string) - The Net Asset Value for that date. - **status** (string) - The status of the request (e.g., 'SUCCESS'). #### Response Example ```json { "meta": { "fund_house": "HDFC Mutual Fund", "scheme_type": "Open Ended Schemes", "scheme_category": "Equity Scheme - Large Cap Fund", "scheme_code": 125497, "scheme_name": "HDFC Top 100 Fund - Direct Plan - Growth", "isin_growth": "INF179K01BB2", "isin_div_reinvestment": null }, "data": [ { "date": "26-10-2024", "nav": "892.45600" } ], "status": "SUCCESS" } ``` ``` -------------------------------- ### Get Latest NAV for a Scheme (curl) Source: https://www.mfapi.in/docs This snippet demonstrates how to retrieve the latest Net Asset Value (NAV) for a specific mutual fund scheme using a curl command. It targets the '/mf/{scheme_code}/latest' endpoint. ```curl curl https://api.mfapi.in/mf/125497/latest ``` -------------------------------- ### List All Mutual Fund Schemes Source: https://www.mfapi.in/docs Retrieve a paginated list of all available mutual fund schemes. Useful for browsing or fetching a large dataset. ```APIDOC ## GET /mf ### Description List all mutual fund schemes with pagination. ### Method GET ### Endpoint `/mf` #### Query Parameters - **limit** (integer) - Optional - The maximum number of schemes to return per page. Defaults to a reasonable limit. - **offset** (integer) - Optional - The number of schemes to skip before starting to collect the result set. Defaults to 0. ### Request Example ``` GET https://api.mfapi.in/mf?limit=100&offset=0 ``` ### Response #### Success Response (200) - **schemeCode** (integer) - The unique code for the mutual fund scheme. - **schemeName** (string) - The name of the mutual fund scheme. #### Response Example ```json [ { "schemeCode": 125497, "schemeName": "HDFC Top 100 Fund - Direct Plan - Growth" }, { "schemeCode": 125498, "schemeName": "HDFC Top 100 Fund - Regular Plan - Growth" } ] ``` ``` -------------------------------- ### Search Mutual Fund Schemes Source: https://www.mfapi.in/docs Search for mutual fund schemes by name. This endpoint allows you to find specific schemes based on keywords. ```APIDOC ## GET /mf/search ### Description Search mutual fund schemes by name. ### Method GET ### Endpoint `/mf/search` #### Query Parameters - **q** (string) - Required - The search query string to find mutual fund schemes. ### Request Example ``` GET https://api.mfapi.in/mf/search?q=HDFC ``` ### Response #### Success Response (200) - **schemeCode** (integer) - The unique code for the mutual fund scheme. - **schemeName** (string) - The name of the mutual fund scheme. #### Response Example ```json [ { "schemeCode": 125497, "schemeName": "HDFC Top 100 Fund - Direct Plan - Growth" }, { "schemeCode": 125498, "schemeName": "HDFC Top 100 Fund - Regular Plan - Growth" } ] ``` ``` -------------------------------- ### Search Mutual Fund Schemes Source: https://www.mfapi.in/docs/openapi Search for mutual fund schemes by name using full-text search. This endpoint allows you to find schemes based on keywords in their names. ```APIDOC ## GET /mf/search ### Description Search for mutual fund schemes by name using full-text search. ### Method GET ### Endpoint /mf/search ### Parameters #### Query Parameters - **q** (string) - Required - Search query string ### Request Example ```json { "example": "?q=HDFC" } ``` ### Response #### Success Response (200) - **schemeCode** (integer) - The unique code for the mutual fund scheme. - **schemeName** (string) - The name of the mutual fund scheme. #### Response Example ```json { "example": [ { "schemeCode": 100119, "schemeName": "HDFC Balanced Advantage Fund - Direct Plan - Growth" }, { "schemeCode": 100120, "schemeName": "HDFC Banking and PSU Debt Fund - Direct Plan - Growth" } ] } ``` ``` -------------------------------- ### Search Schemes Source: https://www.mfapi.in/docs/openapi Searches for mutual fund schemes based on various criteria such as fund house, scheme type, or scheme name. ```APIDOC ## GET /schemes/search ### Description Searches for mutual fund schemes based on provided filters. ### Method GET ### Endpoint /schemes/search ### Parameters #### Query Parameters - **fundHouse** (string) - Optional - Filter by fund house name. - **schemeType** (string) - Optional - Filter by scheme type (e.g., "Open Ended Schemes"). - **schemeCategory** (string) - Optional - Filter by scheme category (e.g., "Equity"). - **schemeName** (string) - Optional - Filter by scheme name (partial match). ### Response #### Success Response (200) - **schemeCode** (integer) - Unique identifier for the scheme. - **schemeName** (string) - Full name of the mutual fund scheme. - **fundHouse** (string) - Name of the fund house. - **schemeType** (string) - Type of the scheme. - **schemeCategory** (string) - Category of the scheme. - **isinGrowth** (string) - ISIN code for growth option (nullable). - **isinDivReinvestment** (string) - ISIN code for dividend reinvestment option (nullable). #### Response Example [ { "schemeCode": 100001, "schemeName": "ICICI Prudential Bluechip Fund", "fundHouse": "ICICI Prudential AMC", "schemeType": "Open Ended Schemes", "schemeCategory": "Equity", "isinGrowth": "INF109K01029", "isinDivReinvestment": "INF109K01128" }, { "schemeCode": 100003, "schemeName": "ICICI Prudential Equity & Debt Fund", "fundHouse": "ICICI Prudential AMC", "schemeType": "Open Ended Schemes", "schemeCategory": "Hybrid", "isinGrowth": "INF109K01342", "isinDivReinvestment": "INF109K01441" } ] ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.