Get request details
curl -X GET "https://test-api.kashier.io/v3/payment/instant-settlements/instant-requests/string"{ "message": "success", "data": { "id": "d2719f9a-3a36-4f10-9c7b-1f2e3d4c5b6a", "requestId": "ISR-1042", "merchantId": "MID-957-917", "status": "PROCESSING", "totalSettlementAmount": 15000, "netTransferAmount": 14743.5, "transactionsCount": 2, "statusHistory": [ { "status": "PENDING", "at": "2026-06-13T08:00:00.000Z", "by": "[email protected]" }, { "status": "PROCESSING", "at": "2026-06-13T08:05:00.000Z", "by": "[email protected]" } ], "unselectedTransactions": [], "unselectedCount": 0, "unselectedSettlementAmount": 0, "linkedBalanceRecords": [ { "recordId": "ISR-1042-20260615", "accountId": "ACC-39550-436-01", "accountName": "Main Account", "amount": -10000, "valueDate": "2026-06-15T00:00:00.000Z", "isReflected": false, "type": "INSTANT_SETTLEMENT_DEDUCTION", "operation": "deduct", "origin": "settlements" }, { "recordId": "ISR-1042-20260616", "accountId": "ACC-39550-436-02", "accountName": "Secondary Account", "amount": -5000, "valueDate": "2026-06-16T00:00:00.000Z", "isReflected": false, "type": "INSTANT_SETTLEMENT_DEDUCTION", "operation": "deduct", "origin": "settlements" } ] }}Returns the full detail of a single instant settlement request: its totals and fee breakdown, its status history, the transactions an agent excluded from it, and the balance-ledger records created for its early-payout deduction.
linkedBalanceRecords is empty while the request is still PENDING, because no deduction has
posted yet. If the balance ledger is temporarily unavailable the details still return, but
with linkedBalanceRecords: null and linkedBalanceRecordsUnavailable: true — retry later to
get the records.
Requires the instant_settlement_request feature flag and the
instant_settlements.all.view_instant_settlement permission.
Authorization
secretKey Merchant secret key used to identify the merchant, obtained from Kashier's dashboard. Pass the raw secret key value in the Authorization header (NOT a "Bearer" token).
In: header
Path Parameters
The request's UUID id or its human-readable requestId (for example ISR-1042).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
Create an instant settlement request POST
Creates an instant settlement request over the selected transactions. The request is created in PENDING status and is then reviewed by Kashier: approval moves it to PROCESSING and deducts the early…
Get request transactions GET
Returns the transactions that belong to a specific request, paginated. Rows an agent removed from the request stay on it and come back with selected: false and an unselectedAt timestamp; use the se…