# 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:** With Basic, <a href="https://twelvedata.com/pricing">Grow</a>, and <a href="https://twelvedata.com/pricing">Pro</a> plans, only 50 records will be in response. <a href="https://twelvedata.com/pricing">Ultra</a>, <a href="https://twelvedata.com/pricing">Enterprise</a> and Custom plans can access complete data on over 140,000 Mutual Funds.

## Parameters

- `symbol` (string, optional)
  Filter by symbol


- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


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


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


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


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


- `fund_family` (string, optional)
  Filter by investment company that manages the fund


- `fund_type` (string, optional)
  Filter by the type of fund


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


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


- `page` (integer, optional)
  Page number


- `outputsize` (integer, optional)
  Number of records in response



## 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"
}
```