Get Payins

API to retrieve the pay-in (fund deposit) transactions for the authenticated user. It returns details such as amount, payment mode, current status, bank name, transaction ID, and applicable charges. The response includes the most recent 20 transactions.

Request

curl --location 'https://api.upstox.com/v2/user/payments/payin' \
--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.

Responses

• 200
• 400

---

Response Body

{
    "status": "success",
    "data": [
        {
            "amount": 16995.00,
            "mode": "NEFT",
            "status": "SUCCESS",
            "currency": "INR",
            "bank_name": "AXIS BANK",
            "transaction_id": "qws_0426_9680091",
            "created_at": "2026-04-19 16:35:36"
        },
        {
            "amount": 100,
            "mode": "UPI",
            "status": "SUCCESS",
            "currency": "INR",
            "bank_name": "AXIS BANK",
            "transaction_id": "order_Sx67XZ8jTEAHiJ",
            "created_at": "2026-06-03 14:17:27"
        }
    ]
}

Name	Type	Description
status	string	Outcome of the request.
data	array	List of pay-in transaction records.
data[].amount	number	Transaction amount in rupees.
data[].mode	string	Payment mode. For e.g. NET_BANKING, UPI, QR, NEFT etc.
data[].currency	string	Currency code. Always INR.
data[].status	string	Current status of the pay-in. One of PENDING, SUCCESS, FAILED, CANCELLED.
data[].bank_name	string	Name of the bank associated with the transaction.
data[].transaction_id	string	Unique identifier for the transaction.
data[].created_at	string	Date and time of the transaction creation in yyyy-MM-dd HH:mm:ss format.

Error codes

Errors follow the standard API error format. Ensure the request is authenticated.

Sample Code

Get payins

Python

import requests

url = 'https://api.upstox.com/v2/user/payments/payin'
headers = {
    'accept': 'application/json',
    'Authorization': 'Bearer {your_access_token}',
}
print(requests.get(url, headers=headers).json())

Node.js

const axios = require('axios');
axios.get('https://api.upstox.com/v2/user/payments/payin', {
  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 {
        HttpRequest req = HttpRequest.newBuilder()
                .uri(URI.create("https://api.upstox.com/v2/user/payments/payin"))
                .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/user/payments/payin';
$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...