Settlements API — list and fetch Razorpay settlements

Retrieve settlement records showing funds transferred to your bank account on the T+2 cycle, including processing fees, GST, and the bank UTR reference.

Razorpay settles funds from captured payments to your bank account on a T+2 business day cycle by default. Each settlement record covers payments, refunds, transfers, and adjustments for a given period.

---

List settlements

GET /v1/settlements

curl -X GET "https://api.razorpay.com/v1/settlements?count=10" \
  -u rzp_test_YOUR_KEY_ID:YOUR_KEY_SECRET

Response

{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "setlmnt_FQzNIarBr3mItW",
      "entity": "settlement",
      "amount": 1000000,
      "status": "processed",
      "fees": 1180,
      "tax": 180,
      "utr": "RAZORPAY12345",
      "created_at": 1591097057
    }
  ]
}

id · string

Unique settlement identifier.

amount · integer

Total amount settled to your bank account, in the smallest currency unit.

status · string

Settlement status. One of created, processed, or failed.

fees · integer

Razorpay processing fees deducted from this settlement, in the smallest currency unit.

tax · integer

Tax charged on processing fees, in the smallest currency unit.

utr · string

Unique Transaction Reference number provided by your bank for the settlement transfer.

created_at · integer

Unix timestamp of when the settlement was created.

---

Fetch a settlement

GET /v1/settlements/:id

curl -X GET https://api.razorpay.com/v1/settlements/setlmnt_FQzNIarBr3mItW \
  -u rzp_test_YOUR_KEY_ID:YOUR_KEY_SECRET