Skip to main content
GET
Available in🇮🇳 India🇲🇾 Malaysia🇸🇬 Singapore🇺🇸 United States
Use this endpoint to retrieve details of all settlements.

Query Parameters

integer
Unix timestamp (in seconds) from when settlements are to be fetched.
integer
Unix timestamp (in seconds) till when settlements are to be fetched.
integer
Number of settlement records to fetch. Defaults to 10. You can fetch a maximum of 100 records. This can be used for pagination, in combination with skip.
integer
Number of settlement records to be skipped. Defaults to 0. This can be used for pagination, in combination with count.

Response Parameters

string
The unique identifier of the settlement transaction.
string
Indicates the type of entity. Here, it is settlement.
integer
The amount to be settled, in the smallest unit of the currency.
string
The currency in which the settlement is initiated. Check the list of supported currencies.
string
The state of the settlement. Possible values: created, processed, failed.
integer
The total fee, in currency subunits, for processing all payments in this settlement. This will always be 0 for Razorpay-settled transactions.
integer
The total tax, in currency subunits, on the processing fees for this settlement. This will always be 0 for Razorpay-settled transactions.
string
Unique Transaction Reference (UTR) number, which can be used to track a particular settlement in your bank account.
integer
Unix timestamp at which the settlement transaction was created.

Errors

Code: 4xxThe API credentials passed in the API call differ from the ones generated on the Dashboard.Solution: The API keys must be active and entered correctly with no whitespace before or after.
Code: 400The from UNIX timestamp is not between 946684800 and 4765046400.Solution: Use a valid UNIX timestamp between 946684800 and 4765046400.
Code: 400The to UNIX timestamp is not between 946684800 and 4765046400.Solution: Use a valid UNIX timestamp between 946684800 and 4765046400.
Code: 400The count passed is 0.Solution: Ensure that count is at least 1.
Code: 400A negative value was passed for the count or skip query parameter. The API responds with count: must be no less than 0. or skip: must be no less than 0. respectively.Solution: Pass count as an integer between 1 and 100, and skip as an integer greater than or equal to 0.
Code: 400A non-integer value (for example a string like abc, or a human-readable date like 2024-01-01) was passed for one of the pagination or range query parameters. The API responds with a message of the form <field>: strconv.Atoi: parsing "<value>": invalid syntax.Solution: Pass all four query parameters (count, skip, from, to) as integers. from and to must be UNIX-epoch seconds, not human-readable dates.
Last modified on November 18, 2026