Wallet
Get Settlements
GET
https://backendapi.sayswitchgroup.com/api/v1/settlementThe Settlements API allows you to retrieve a list of payments that have been settled in your account.
This endpoint returns a paginated list of all settled payments in your account, including details about each settlement.
Example cURL Request
cURL
curl -X GET https://backendapi.sayswitchgroup.com/api/v1/settlement \
-H "Authorization: Bearer YOUR_SECRET_KEY"Sample Response
JSON
{
"success": true,
"message": "Settlement retrieved",
"data": [
{
"id": 80,
"batchid": "17681d32e1503",
"currency": "NGN",
"total_amount": "101.2",
"settled_amount": "100",
"domain": "live",
"status": "success",
"subaccount": null,
"created_at": "2025-03-26T01:31:02.000000Z",
"updated_at": "2025-03-26T01:31:02.000000Z"
},
{
"id": 42,
"batchid": "0718219978657",
"currency": "NGN",
"total_amount": "20.24",
"settled_amount": "20",
"domain": "live",
"status": "success",
"subaccount": null,
"created_at": "2024-09-10T01:31:02.000000Z",
"updated_at": "2024-09-10T01:31:02.000000Z"
},
{
"id": 26,
"batchid": "077b766557663",
"currency": "NGN",
"total_amount": "50.6",
"settled_amount": "50",
"domain": "live",
"status": "success",
"subaccount": null,
"created_at": "2024-08-13T01:31:02.000000Z",
"updated_at": "2024-08-13T01:31:02.000000Z"
},
{
"id": 16,
"batchid": "9f8ac86615a25",
"currency": "NGN",
"total_amount": "121.68",
"settled_amount": "120",
"domain": "live",
"status": "success",
"subaccount": null,
"created_at": "2024-07-28T01:31:02.000000Z",
"updated_at": "2024-07-28T01:31:02.000000Z"
},
// and more
],
"meta": {
"total": 4
}
}