Docs Logo

Transactions

Fetch All Transactions

Fetch Transactions With ID

Docs Logo

API Test keys

Api

X

Transactions

Fetch All

API Test keys

Api

X

Transactions

Fetch All

Fetch All Transactions

GET
/v1/transactions?account_number=\{account number\}

Click to copy

Use this endpoint to retrieve the details of all transactions.

Is this page helpful?

Curl

1
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2
    -X GET https://api.razorpay.com/v1/transactions?account_number=7878780080316316

Success

1
{
2
  "entity":"collection",
3
  "count":2,
4
  "items":[
5
    {
6
      "id":"txn_00000000000001",
7
      "entity":"transaction",
8
      "account_number":"1121431121541121",
9
      "amount":10000000,
10
      "currency":"INR",
11
      "credit":10000000,
12
      "debit":0,
13
      "balance":10000000,
14
      "source":{
15
        "id":"bt_00000000000001",
16
        "entity":"bank_transfer",
17
        "payer_name":"Saurav Kumar",
18
        "payer_account":"6543266545411243",
19
        "payer_ifsc":"UTIB0000002",
20
        "mode":"NEFT",
21
        "bank_reference":"AXIR000000000001",
22
        "amount":10000000
23
      },
24
      "created_at":1545125568
25
    },
26
    {
27
      "id":"txn_00000000000003",
28
      "entity":"transaction",
29
      "account_number":"7878780080316316",
30
      "amount":1000000,
31
      "currency":"INR",
32
      "credit":0,
33
      "debit":1000000,
34
      "balance":9000000,
35
      "source":{
36
        "id":"pout_00000000000001",
37
        "entity":"payout",
38
        "fund_account_id":"fa_00000000000001",
39
        "amount":1000000,
40
        "notes":{
41
          "notes_key_1": "Tea, Earl Grey, Hot",
42
          "notes_key_2": "Tea, Earl Grey… decaf."
43
        },
44
        "fees":3,
45
        "tax":1,
46
        "status":"processed",
47
        "utr":"000000000001",
48
        "mode":"NEFT",
49
        "created_at":1545224066,
50
        "fee_type": null
51
      },
52
      "created_at":1545224066
53
    }
54
  ]
55
}
Path Parameters
account_number

*

string

The account from which you want to make the payout.
Account details can be found on the RazorpayX Dashboard. For example, 7878780080316316.

Watch Out!

  • This is not your contact's bank account number. Log in to your
    RazorpayX Dashboard
    and go to My Account & Settings → Banking → Customer Identifier.
  • This value is different for Test Mode and Live Mode.

Query Parameters
from
integer

Timestamp, in Unix, from when you want to fetch transactions.

to
integer

Timestamp, in Unix, till when you want to fetch transactions.

count
integer

Number of payouts to be fetched. Default value is 10. Maximum value is 100. This can be used for pagination, in combination with skip.

skip
integer

Numbers of payouts to be skipped. Default value is 0. This can be used for pagination, in combination with count.

Response Parameters
id
string

The unique identifier linked to the transaction. For example, txn_00000000000001.

entity
string

The entity created. Here, it is transaction.

account_number
string

The business account from which the payout was made. For example, 7878780080316316.

amount
integer

The amount transferred, in paise. The transfer can either be a credit (when you add funds to your account) or a debit (when you make a payout).

The value passed here does not include fees and tax. Fees and tax, if any, are deducted from your account balance.

currency
string

The transaction currency. Here, it is INR.

credit
integer

The amount, in paise, credited to your account. Is 0 for debit transactions (when making payouts).

debit
integer

The amount, in paise, debited to your account. Is 0 for credit transactions (when adding funds to your account).

balance
integer

The remaining amount, in paise, in your account after the debit or credit transaction.

source
object

Details of the payout made or details of the bank account from which money was added to your business account.

Show child parameters (10)

fees
integer

The fees, in paise, for the transaction. This field is populated only when the transaction moves to the processing state. For example, 5.
This value is returned only when the source entity is payout.

tax
integer

The tax, in paise, for the fee being charged. This field is populated only when the transaction moves to the processing state. For example, 1.
This value is returned only when the source entity is payout.

status
string

The status of the transaction. A transaction can be in any of the following states:

  • pending
  • queued
  • processing
  • processed
  • reversed
  • cancelled
  • rejected

This value is returned only when the source entity is payout.

utr
string

The unique transaction number for the transaction. For example, HDFCN00000000001.
This value is returned only when the source entity is payout.

mode
string

The payout mode. Refer to the

Supported Banks and Payout Modes section

for more details.
This value is returned only when the source entity is payout.

created_at
integer

Timestamp, in Unix, when the source entity or transaction entity was created. For example, 1545320320.

Fetch All Transactions

GET
/v1/transactions?account_number=\{account number\}

Click to copy

Use this endpoint to retrieve the details of all transactions.

Is this page helpful?

Path Parameters
account_number

*

string

The account from which you want to make the payout.
Account details can be found on the RazorpayX Dashboard. For example, 7878780080316316.

Watch Out!

  • This is not your contact's bank account number. Log in to your
    RazorpayX Dashboard
    and go to My Account & Settings → Banking → Customer Identifier.
  • This value is different for Test Mode and Live Mode.

Query Parameters
from
integer

Timestamp, in Unix, from when you want to fetch transactions.

to
integer

Timestamp, in Unix, till when you want to fetch transactions.

count
integer

Number of payouts to be fetched. Default value is 10. Maximum value is 100. This can be used for pagination, in combination with skip.

skip
integer

Numbers of payouts to be skipped. Default value is 0. This can be used for pagination, in combination with count.

Response Parameters
id
string

The unique identifier linked to the transaction. For example, txn_00000000000001.

entity
string

The entity created. Here, it is transaction.

account_number
string

The business account from which the payout was made. For example, 7878780080316316.

amount
integer

The amount transferred, in paise. The transfer can either be a credit (when you add funds to your account) or a debit (when you make a payout).

The value passed here does not include fees and tax. Fees and tax, if any, are deducted from your account balance.

currency
string

The transaction currency. Here, it is INR.

credit
integer

The amount, in paise, credited to your account. Is 0 for debit transactions (when making payouts).

debit
integer

The amount, in paise, debited to your account. Is 0 for credit transactions (when adding funds to your account).

balance
integer

The remaining amount, in paise, in your account after the debit or credit transaction.

source
object

Details of the payout made or details of the bank account from which money was added to your business account.

Show child parameters (10)

fees
integer

The fees, in paise, for the transaction. This field is populated only when the transaction moves to the processing state. For example, 5.
This value is returned only when the source entity is payout.

tax
integer

The tax, in paise, for the fee being charged. This field is populated only when the transaction moves to the processing state. For example, 1.
This value is returned only when the source entity is payout.

status
string

The status of the transaction. A transaction can be in any of the following states:

  • pending
  • queued
  • processing
  • processed
  • reversed
  • cancelled
  • rejected

This value is returned only when the source entity is payout.

utr
string

The unique transaction number for the transaction. For example, HDFCN00000000001.
This value is returned only when the source entity is payout.

mode
string

The payout mode. Refer to the

Supported Banks and Payout Modes section

for more details.
This value is returned only when the source entity is payout.

created_at
integer

Timestamp, in Unix, when the source entity or transaction entity was created. For example, 1545320320.

Curl

1
curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2
    -X GET https://api.razorpay.com/v1/transactions?account_number=7878780080316316

Success

1
{
2
  "entity":"collection",
3
  "count":2,
4
  "items":[
5
    {
6
      "id":"txn_00000000000001",
7
      "entity":"transaction",
8
      "account_number":"1121431121541121",
9
      "amount":10000000,
10
      "currency":"INR",
11
      "credit":10000000,
12
      "debit":0,
13
      "balance":10000000,
14
      "source":{
15
        "id":"bt_00000000000001",
16
        "entity":"bank_transfer",
17
        "payer_name":"Saurav Kumar",
18
        "payer_account":"6543266545411243",
19
        "payer_ifsc":"UTIB0000002",
20
        "mode":"NEFT",
21
        "bank_reference":"AXIR000000000001",
22
        "amount":10000000
23
      },
24
      "created_at":1545125568
25
    },
26
    {
27
      "id":"txn_00000000000003",
28
      "entity":"transaction",
29
      "account_number":"7878780080316316",
30
      "amount":1000000,
31
      "currency":"INR",
32
      "credit":0,
33
      "debit":1000000,
34
      "balance":9000000,
35
      "source":{
36
        "id":"pout_00000000000001",
37
        "entity":"payout",
38
        "fund_account_id":"fa_00000000000001",
39
        "amount":1000000,
40
        "notes":{
41
          "notes_key_1": "Tea, Earl Grey, Hot",
42
          "notes_key_2": "Tea, Earl Grey… decaf."
43
        },
44
        "fees":3,
45
        "tax":1,
46
        "status":"processed",
47
        "utr":"000000000001",
48
        "mode":"NEFT",
49
        "created_at":1545224066,
50
        "fee_type": null
51
      },
52
      "created_at":1545224066
53
    }
54
  ]
55
}