Get Order SIPs

This API provides the mutual fund SIP registrations for the user. Use page_number and records for pagination.

Request

curl --location 'https://api.upstox.com/v2/mf/sips?page_number=1&records=10' \
--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.

Query Parameters

Name	Required	Type	Description
page_number	false	integer	Page number, starting from 1. Default: 1
records	false	integer	Records per page. Default: 10, Max: 30.

Responses

• 200
• 400

---

Response Body

{
    "status": "success",
    "data": [
        {
            "instrument_key": "INF179KB15Q6",
            "fund": "HDFC Ultra S/T Fund Direct Growth",
            "dividend_type": "Growth",
            "status": "ACTIVE",
            "created": "2025-03-11 00:00:00.0",
            "frequency": "MONTHLY",
            "instalments": 999,
            "sip_id": "133321093",
            "transaction_type": "BUY",
            "next_instalment": "2025-04-11 00:00:00.0",
            "instalment_amount": 300.0,
            "last_instalment": "2025-03-11 00:00:00.0",
            "pending_instalments": 0,
            "instalment_day": 11,
            "trigger_price": 0.0,
            "sip_type": "Auto",
            "completed_instalments": 0
        },
        {
            "instrument_key": "INF174K01JI7",
            "fund": "Kotak Bond Short Term Plan Direct Growth",
            "dividend_type": "Growth",
            "status": "ACTIVE",
            "created": "2025-03-11 00:00:00.0",
            "frequency": "MONTHLY",
            "instalments": 999,
            "sip_id": "133321205",
            "transaction_type": "BUY",
            "next_instalment": "2025-04-11 00:00:00.0",
            "instalment_amount": 1000.0,
            "last_instalment": "2025-03-11 00:00:00.0",
            "pending_instalments": 0,
            "instalment_day": 30,
            "trigger_price": 0.0,
            "sip_type": "Auto",
            "completed_instalments": 1
        }
    ],
    "meta_data": {
        "page": {
            "page_number": 1,
            "total_pages": 1,
            "records": 10,
            "total_records": 2
        }
    }
}

Name	Type	Description
status	string	Outcome of the request.
data	array	SIP rows.
data[].sip_id	string	SIP identifier.
data[].instrument_key	string	Fund ISIN when available.
data[].fund	string	Scheme display name.
data[].dividend_type	string	Dividend option: Dividend Payout, Dividend Reinvestment, or Growth.
data[].transaction_type	string	Typically BUY or SELL.
data[].status	string	SIP status: ACTIVE, ARCHIVED, CANCEL_REQUESTED, CANCELLED, CREATED, FAILED, NEW, PAUSE, PAUSED, PENDING, REGISTERED, REJECTED, or SUSPENDED.
data[].created	string	When the SIP was registered in format: YYYY-MM-DD HH:mm:ss.
data[].frequency	string	Typically MONTHLY or WEEKLY.
data[].next_instalment	string	Next instalment date in format: YYYY-MM-DD.
data[].instalment_amount	number	Amount per instalment.
data[].instalments	integer	Total instalments, or -1 when open-ended.
data[].last_instalment	string	Last triggered instalment time in format: YYYY-MM-DD.
data[].pending_instalments	integer	Pending count when applicable.
data[].instalment_day	integer	Day of month for monthly SIPs when applicable.
data[].completed_instalments	integer	Completed count when available.
data[].trigger_price	number	Trigger price when applicable.
data[].sip_type	string	SIP type: Manual or Auto.
meta_data	object	Pagination metadata (same shape as orders API).
meta_data.page	object	Page metadata.
meta_data.page.page_number	integer	Current page.
meta_data.page.total_pages	integer	Total pages.
meta_data.page.records	integer	Page size used.
meta_data.page.total_records	integer	Total rows across pages.

Error codes

Error code	Description
UDAPI1173	Page records exceeds limit — records must not exceed 30.
UDAPI1174	Page number must be greater than or equal to 1 — page_number must be at least 1.
UDAPI1196	Records must be greater than or equal to 1 — records must be at least 1.

Sample Code

Get mutual fund SIPs

Python

import requests

url = 'https://api.upstox.com/v2/mf/sips'
params = {'page_number': 1, 'records': 10}
headers = {
    'accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}',
}
print(requests.get(url, params=params, headers=headers).json())

Node.js

const axios = require('axios');
axios.get('https://api.upstox.com/v2/mf/sips', {
  params: { page_number: 1, records: 10 },
  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 url = "https://api.upstox.com/v2/mf/sips?page_number=1&records=10";
        HttpRequest req = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("accept", "application/json")
                .header("Authorization", "Bearer {your_access_token}")
                .GET()
                .build();
        System.out.println(HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString()).body());
    }
}

PHP

<?php
$url = 'https://api.upstox.com/v2/mf/sips?' . http_build_query(['page_number' => 1, 'records' => 10]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'accept: application/json',
    'Authorization: Bearer {your_access_token}',
]);
echo curl_exec($ch);
curl_close($ch);

Loading...