---
title: "List Funds"
method: POST
path: "/api/instruments/resolve"
tags: ["Funds"]
---

# List Funds

`POST /api/instruments/resolve`

## Request

- Base URL: `https://api.harmoney.in`
- URL: `https://api.harmoney.in/api/instruments/resolve`
- Auth: API key in header `x-api-key`

Resolve fund names, ISINs or instrument ids to matching mutual fund share classes, ranked best-first.

Send up to 100 lookups in one call. Results come back in the order sent, and an empty `candidates` list means nothing matched. Use the returned `unique_id` with every other endpoint in this feed.

To fetch a single fund, send one query — pass its `unique_id` or ISIN as the query `value`.

## Request body

- ResolveRequest
  - `queries` ResolveQueryIn[], required: 1-100 lookups resolved in one call. Results come back in the order sent.
    - `type` 'text' | 'unique_id' | 'isin', required: The kind of value a unified-search resolve query carries. TICKER / ISIN map to the corresponding ``IdentifierType`` internally.
    - `value` string, required
  - `instrument_types` string[], required: Fixed to `Mutual Fund` for this feed. Send it on every request — omitting it widens the lookup to every instrument type.

## Response `200`

Successful Response

- ResolveResponse
  - `results` ResolveResult[], required
    - `query` ResolveQueryIn, required
      - `type` 'text' | 'unique_id' | 'isin', required: The kind of value a unified-search resolve query carries. TICKER / ISIN map to the corresponding ``IdentifierType`` internally.
      - `value` string, required
    - `candidates` MatchResponse[], required
      - `unique_id` string, required
      - `display` string, required
      - `instrument_type` 'Mutual Fund': Always `Mutual Fund` in this feed.
      - `identifiers` IdentifierResponse[]
        - `type` 'ISIN' | 'SCHEME_ID' | 'PLAN_ID' | 'AMC_ID', required: Mutual fund share classes carry an ISIN; the others appear only where the registry has them.
        - `value` string, required
      - `score` number

## Other responses

- `400`: Bad Request
- `422`: Validation Error

---

[API](https://skmtc.dev/inferedge/apis/india-mutual-funds-data-feed.md) - [All operations](https://skmtc.dev/inferedge/apis/india-mutual-funds-data-feed/llms.txt) - [OpenAPI document](https://skmtc.dev/inferedge/apis/india-mutual-funds-data-feed/revisions/fe0d3be721c0?raw)