# MFs directory (Useful)

The mutual funds directory endpoint provides a daily updated list of mutual funds, sorted in descending order by their total assets value. This endpoint is useful for retrieving an organized overview of available mutual funds.

**API credits cost:** `1` per request

> **Note:** Basic, <a href="https://twelvedata.com/pricing">Grow</a>, and <a href="https://twelvedata.com/pricing">Pro</a> plans (individual) and <a href="https://twelvedata.com/pricing-business">Venture</a> plan (business) return up to 50 records. For complete data on over 140,000 Mutual Funds, upgrade to the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual), <a href="https://twelvedata.com/pricing-business">Enterprise</a> (business), or Custom plan (business).

## Parameters

- `symbol` (string, optional)
  Filter by symbol
  Example value: `1535462D`


- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG00HMMLCH1`


- `isin` (string, optional)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section
  Example value: `LU1206782309`


- `cusip` (string, optional)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section
  Example value: `120678230`


- `cik` (string, optional)
  The CIK of an instrument for which data is requested
  Example value: `95953`


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`
  Example value: `United States`


- `fund_family` (string, optional)
  Filter by investment company that manages the fund
  Example value: `Jackson National`


- `fund_type` (string, optional)
  Filter by the type of fund
  Example value: `Small Blend`


- `performance_rating` (integer, optional)
  Filter by performance rating from `0` to `5`
  Example value: `4`


- `risk_rating` (integer, optional)
  Filter by risk rating from `0` to `5`
  Example value: `4`


- `format` (string, optional)
  The format of the response data
  Available values: `JSON`, `CSV`
  Default value: `JSON`


- `delimiter` (string, optional)
  The separator used in the CSV response data
  Default value: `;`


- `dp` (integer, optional)
  Number of decimal places for floating values
  Default value: `5`


- `page` (integer, optional)
  Page number
  Default value: `1`


- `outputsize` (integer, optional)
  Number of records in response
  Default value: `100`



## Response

- `result` (object)
  Response result
  - `count` (integer)
    Total number of matching funds
  - `list` (array of object)
    List of mutual funds
    - `symbol` (string)
      Fund symbol ticker
    - `name` (string)
      Fund name
    - `country` (string)
      Country of fund incorporation
    - `fund_family` (string)
      Investment company that manages the fund
    - `fund_type` (string)
      Type of fund
    - `performance_rating` (integer)
      Performance rating from `0` to `5`
    - `risk_rating` (integer)
      Risk rating from `0` to `5`
    - `currency` (string)
      Currency code in which the fund is denominated
    - `exchange` (string)
      Exchange name where the fund is listed
    - `mic_code` (string)
      Market identifier code (MIC) under ISO 10383 standard

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/mutual_funds/list?apikey=demo"
```

## Example Response

```json
{
    "result": {
        "count": 1000,
        "list": [
            {
                "symbol": "0P0001LCQ3",
                "name": "JNL Small Cap Index Fund (I)",
                "country": "United States",
                "fund_family": "Jackson National",
                "fund_type": "Small Blend",
                "performance_rating": 2,
                "risk_rating": 4,
                "currency": "USD",
                "exchange": "OTC",
                "mic_code": "OTCM"
            }
        ]
    },
    "status": "ok"
}
```