Get Order Details

This API provides the status and full details for a specific mutual fund order. Call with a valid order_id for an order that belongs to the user account.

Request

curl --location 'https://api.upstox.com/v2/mf/orders/a1b2c3d4-order-id' \
--header 'accept: application/json' \
--header 'Authorization: Bearer {your_access_token}'

Additional samples in various languages are available in the Sample Code section on this page.

Path Parameters

Name	Required	Type	Description
order_id	true	string	Mutual fund order id.

Responses

• 200
• 400

---

Response Body

{
    "status": "success",
    "data": {
        "instrument_key": "INF109K01Q49",
        "status": "INPROCESS",
        "status_message": null,
        "folio": "",
        "fund": "ICICI Prudential Liquid Fund Direct Plan Growth",
        "amount": 1000.0,
        "quantity": 0.0,
        "price": 0.0,
        "order_id": "ABC123-a9b52e90-3de6-4674-84b9-e3bcced7ec30",
        "exchange_order_id": "254657127",
        "order_timestamp": "2026-03-12 15:17:42",
        "exchange_timestamp": null,
        "transaction_type": "BUY",
        "last_price": 0.0,
        "average_price": 0.0,
        "settlement_id": "254657127",
        "variety": "REGULAR",
        "purchase_type": "FRESH",
        "last_price_date": "2026-03-06"
    }
}

Name	Type	Description
status	string	Outcome of the request. Typically success or error.
data	object	Single mutual fund order object.
data.order_id	string	Unique order identifier.
data.exchange_order_id	string	Exchange order id when available.
data.instrument_key	string	Fund ISIN when available.
data.status	string	Current order status.
data.status_message	string	Human-readable status or rejection reason.
data.folio	string	Folio when allotted.
data.fund	string	Fund or scheme display name.
data.order_timestamp	string	When the order was registered in format: YYYY-MM-DD HH:mm:ss.
data.exchange_timestamp	string	Exchange date when available in format: YYYY-MM-DD HH:mm:ss.
data.settlement_id	string	Settlement id when available.
data.transaction_type	string	BUY or SELL.
data.amount	number	Order amount.
data.variety	string	Order variety either REGULAR or SIP.
data.purchase_type	string	FRESH or ADDITIONAL when applicable.
data.quantity	number	Units allotted or sold.
data.price	number	Price or NAV when available.
data.last_price	number	Last known NAV.
data.average_price	number	Allotted or sold NAV.
data.last_price_date	string	Date for last NAV when available in format: YYYY-MM-DD.

Error codes

Errors follow the standard API error format. Ensure the request is authenticated and your account has access to mutual fund data.

Sample Code

Get mutual fund order by id

Python

import requests

order_id = 'a1b2c3d4-order-id'
url = f'https://api.upstox.com/v2/mf/orders/{order_id}'
headers = {
    'accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}',
}

response = requests.get(url, headers=headers)
print(response.status_code, response.json())

Node.js

const axios = require('axios');
const orderId = 'a1b2c3d4-order-id';
axios.get(`https://api.upstox.com/v2/mf/orders/${orderId}`, {
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer {your_access_token}',
  },
}).then(r => console.log(r.data));

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        String orderId = "a1b2c3d4-order-id";
        String url = "https://api.upstox.com/v2/mf/orders/" + orderId;
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("accept", "application/json")
                .header("Authorization", "Bearer {your_access_token}")
                .GET()
                .build();
        HttpResponse<String> res = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(res.body());
    }
}

PHP

<?php
$orderId = 'a1b2c3d4-order-id';
$url = 'https://api.upstox.com/v2/mf/orders/' . rawurlencode($orderId);
$headers = [
    'accept: application/json',
    'Authorization: Bearer {your_access_token}',
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
echo curl_exec($ch);
curl_close($ch);

Loading...