Fetch All Payout Links

GET

/v1/payout-links

Click to copy

Use this endpoint to retrieve all the Payout Links created.

Is this page helpful?

Curl

1curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2    -X GET https://api.razorpay.com/v1/payout-links

Success

1{
2  "entity":"collection",
3  "count":2,
4  "items":[
5    {
6      "id":"poutlk_00000000000001",
7      "entity":"payout_link",
8      "contact_id":"cont_00000000000001",
9      "contact":{
10        "name":"Gaurav Kumar",
11        "email":"gaurav.kumar@example.com",
12        "contact":"912345678"
13      },
14      "fund_account_id":"fa_00000000000001",
15      "purpose":"refund",
16      "status":"processed",
17      "amount":1000,
18      "currency":"INR",
19      "description":"Payout link for Gaurav Kumar",
20      "attempt_count": 1,
21      "receipt":"Receipt No. 1",
22      "notes":{
23        "notes_key_1":"Tea, Earl Grey, Hot",
24        "notes_key_2":"Tea, Earl Grey… decaf."
25      },
26      "short_url":"https://rzp.io/i/3b1Tw6",
27      "send_sms": true,
28      "send_email": true,
29      "cancelled_at":null,
30      "created_at":1545383037,
31      "expire_by": 1545384058,
32      "expired_at": 1545384658
33    },
34    {
35      "id":"poutlk_00000000000002",
36      "entity":"payout_link",
37      "contact_id":"cont_00000000000001",
38      "contact":{
39        "name":"Gaurav Kumar",
40        "contact":"912345678",
41        "email":"gaurav.kumar@example.com"
42      },
43      "fund_account_id":null,
44      "purpose":"refund",
45      "status":"issued",
46      "amount":1000,
47      "currency":"INR",
48      "description":"Payout link for Gaurav Kumar",
49      "attempt_count": 0,
50      "receipt":"Receipt No. 2",
51      "notes":{
52        "notes_key_1":"Tea, Earl Grey, Hot",
53        "notes_key_2":"Tea, Earl Grey… decaf."
54      },
55      "short_url":"https://rzp.io/i/3b1Tw6",
56      "send_sms": true,
57      "send_email": true,
58      "cancelled_at":null,
59      "created_at":1545383037,
60      "expire_by": 1545384058,
61      "expired_at": 1545384658
62    }
63  ]
64}

Query Parameters

Pass any of the following parameters as required to retrieve Payout Links as necessary.

from

integer

Timestamp, in Unix, from when Payout Links are to be retrieved.

to

integer

Timestamp, in Unix, till when Payout Links are to be retrieved.

count

integer

The number of Payout Links to be retrieved. The default value is 10. The maximum value is 100. This can be used for pagination in combination with skip.

skip

integer

The numbers of Payout Links to be skipped. The default value is 0. This can be used for pagination in combination with count.

id

string

The unique identifier for the Payout Link. For example, poutlk_00000000000001.

contact_id

string

The unique identifier of the contact to whom the Payout Link was sent to. For example, cont_00000000000001.

contact_phone_number

string

The contact's phone number. For example, 9000090000.

contact_email

string

The contact's email address. For example, gaurav.kumar@example.com.

fund_account_id

string

The unique identifier of the contact's fund account to which the payout was made. For example, fa_00000000000001.

purpose

string

The purpose of the payout that was created. For example, refund.

status

string

The Payout Link status. Possible values:

issued
processing
processed
cancelled

receipt

string

A user-entered receipt number for the payout. For example, Receipt No. 1.

short_url

string

A short link for the Payout Link that was created. This was the link shared with the contact.

Response Parameters

count

integer

The number of Payout Links you requested to retrieve.

entity

string

The entity created. Here it is collection.

id

string

The unique identifier of the Payout Link created. For example, poutlk_00000000000001.

entity

string

The entity created. Here it is payout_link.

contact

object

Details of the contact to whom the Payout Link was sent to.

Show child parameters (4)

purpose

string

The purpose of the payout. For example, refund, cashback or payout.

status

string

The Payout Link status. Possible values:

pending
issued
processing
processed
cancelled
rejected

Refer to the
Payout Link Life Cycle section
for more details.

amount

integer

The amount, in paise, transferred from the business account to the contact's fund account.

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

currency

string

The currency in which the payout was made. Here, it is INR.

description

string

A user-entered description for the Payout Link. For example, Payout link for Gaurav Kumar.

short_url

string

A short link for the Payout Link that was created. This is the link that was shared with the contact.

created_at

integer

Timestamp, in Unix, when the Payout Link was created.

contact_id

string

The unique identifier of the contact to whom the Payout Link was sent. For example, cont_00000000000001.

send_sms

boolean

Possible values:

true: SMS sent to the provided contact number.
false: SMS could not be sent to the provided contact number. This could be because the contact number provided was wrong.

send_email

boolean

Possible values:

true: Email sent to the provided email address.
false: Email could not be sent to the provided email address. This could be because the email address provided was wrong.

fund_account_id

string

The unique identifier of the contact's fund account to which the payout was made. For example, fa_00000000000001.

Fund Account id is returned only when the Payout Link moves to the

processing state

after the contact provides their account details.

payout_id

string

The unique identifier for the payout made to the contact. For example, pout_00000000000001.

This value is returned only when the Payout Link moves to the

processed state

after the contact receives the amount in their account.

cancelled_at

integer

Timestamp, in Unix, if the Payout Link was cancelled by you. This value is returned only when the Payout Link moves to the cancelled state.

attempt_count

integer

The number of attempts to complete the payout. For example, 0.

receipt

string

A user-entered receipt number for the payout. For example, Receipt No. 1.

notes

object

User-entered notes for internal reference. This is a key-value pair. For example, "note_key": "Beam me up Scotty”.

expire_by

integer

Timestamp, in Unix, when the Payout Link was to expire. This is set at the time of creation of the Payout Link and is set at least 15 minutes ahead of the current time.

This value is returned only if you have enabled the expiry feature for Payout Links. Know how to

set expiry

to Payout Links.

expired_at

integer

Timestamp, in Unix, when the Payout Link expired. This is set at the time of creation of the Payout Link.

Fetch All Payout Links

GET

/v1/payout-links

Click to copy

Use this endpoint to retrieve all the Payout Links created.

Is this page helpful?

Query Parameters

Pass any of the following parameters as required to retrieve Payout Links as necessary.

from

integer

Timestamp, in Unix, from when Payout Links are to be retrieved.

to

integer

Timestamp, in Unix, till when Payout Links are to be retrieved.

count

integer

The number of Payout Links to be retrieved. The default value is 10. The maximum value is 100. This can be used for pagination in combination with skip.

skip

integer

The numbers of Payout Links to be skipped. The default value is 0. This can be used for pagination in combination with count.

id

string

The unique identifier for the Payout Link. For example, poutlk_00000000000001.

contact_id

string

The unique identifier of the contact to whom the Payout Link was sent to. For example, cont_00000000000001.

contact_phone_number

string

The contact's phone number. For example, 9000090000.

contact_email

string

The contact's email address. For example, gaurav.kumar@example.com.

fund_account_id

string

The unique identifier of the contact's fund account to which the payout was made. For example, fa_00000000000001.

purpose

string

The purpose of the payout that was created. For example, refund.

status

string

The Payout Link status. Possible values:

issued
processing
processed
cancelled

receipt

string

A user-entered receipt number for the payout. For example, Receipt No. 1.

short_url

string

A short link for the Payout Link that was created. This was the link shared with the contact.

Response Parameters

count

integer

The number of Payout Links you requested to retrieve.

entity

string

The entity created. Here it is collection.

id

string

The unique identifier of the Payout Link created. For example, poutlk_00000000000001.

entity

string

The entity created. Here it is payout_link.

contact

object

Details of the contact to whom the Payout Link was sent to.

Show child parameters (4)

purpose

string

The purpose of the payout. For example, refund, cashback or payout.

status

string

The Payout Link status. Possible values:

pending
issued
processing
processed
cancelled
rejected

Refer to the
Payout Link Life Cycle section
for more details.

amount

integer

currency

string

The currency in which the payout was made. Here, it is INR.

description

string

A user-entered description for the Payout Link. For example, Payout link for Gaurav Kumar.

short_url

string

A short link for the Payout Link that was created. This is the link that was shared with the contact.

created_at

integer

Timestamp, in Unix, when the Payout Link was created.

contact_id

string

The unique identifier of the contact to whom the Payout Link was sent. For example, cont_00000000000001.

send_sms

boolean

Possible values:

true: SMS sent to the provided contact number.
false: SMS could not be sent to the provided contact number. This could be because the contact number provided was wrong.

send_email

boolean

Possible values:

true: Email sent to the provided email address.
false: Email could not be sent to the provided email address. This could be because the email address provided was wrong.

fund_account_id

string

The unique identifier of the contact's fund account to which the payout was made. For example, fa_00000000000001.

Fund Account id is returned only when the Payout Link moves to the

processing state

after the contact provides their account details.

payout_id

string

The unique identifier for the payout made to the contact. For example, pout_00000000000001.

This value is returned only when the Payout Link moves to the

processed state

after the contact receives the amount in their account.

cancelled_at

integer

Timestamp, in Unix, if the Payout Link was cancelled by you. This value is returned only when the Payout Link moves to the cancelled state.

attempt_count

integer

The number of attempts to complete the payout. For example, 0.

receipt

string

A user-entered receipt number for the payout. For example, Receipt No. 1.

notes

object

User-entered notes for internal reference. This is a key-value pair. For example, "note_key": "Beam me up Scotty”.

expire_by

integer

set expiry

to Payout Links.

expired_at

integer

Timestamp, in Unix, when the Payout Link expired. This is set at the time of creation of the Payout Link.

Curl

1curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
2    -X GET https://api.razorpay.com/v1/payout-links

Success

1{
2  "entity":"collection",
3  "count":2,
4  "items":[
5    {
6      "id":"poutlk_00000000000001",
7      "entity":"payout_link",
8      "contact_id":"cont_00000000000001",
9      "contact":{
10        "name":"Gaurav Kumar",
11        "email":"gaurav.kumar@example.com",
12        "contact":"912345678"
13      },
14      "fund_account_id":"fa_00000000000001",
15      "purpose":"refund",
16      "status":"processed",
17      "amount":1000,
18      "currency":"INR",
19      "description":"Payout link for Gaurav Kumar",
20      "attempt_count": 1,
21      "receipt":"Receipt No. 1",
22      "notes":{
23        "notes_key_1":"Tea, Earl Grey, Hot",
24        "notes_key_2":"Tea, Earl Grey… decaf."
25      },
26      "short_url":"https://rzp.io/i/3b1Tw6",
27      "send_sms": true,
28      "send_email": true,
29      "cancelled_at":null,
30      "created_at":1545383037,
31      "expire_by": 1545384058,
32      "expired_at": 1545384658
33    },
34    {
35      "id":"poutlk_00000000000002",
36      "entity":"payout_link",
37      "contact_id":"cont_00000000000001",
38      "contact":{
39        "name":"Gaurav Kumar",
40        "contact":"912345678",
41        "email":"gaurav.kumar@example.com"
42      },
43      "fund_account_id":null,
44      "purpose":"refund",
45      "status":"issued",
46      "amount":1000,
47      "currency":"INR",
48      "description":"Payout link for Gaurav Kumar",
49      "attempt_count": 0,
50      "receipt":"Receipt No. 2",
51      "notes":{
52        "notes_key_1":"Tea, Earl Grey, Hot",
53        "notes_key_2":"Tea, Earl Grey… decaf."
54      },
55      "short_url":"https://rzp.io/i/3b1Tw6",
56      "send_sms": true,
57      "send_email": true,
58      "cancelled_at":null,
59      "created_at":1545383037,
60      "expire_by": 1545384058,
61      "expired_at": 1545384658
62    }
63  ]
64}