get https://api.vendy.money/transactions
Endpoint to retrieve all business transactions on Vendy. This endpoint supports two forms for pagination; setting the time period for which transactions should be retrieved (via 'start' and 'end' query parameters) or number of transactions to be returned (via 'limit' query parameter).
Request:
Parameter | Type | Description | Required |
---|---|---|---|
start | Integer(milliseconds since epoch) | A starting time period to get transactions from | false |
end | Integer(milliseconds since epoch) | A ending time period to get transactions from | false |
limit | String | Number of items to be returned in format (start, end) e.g (0, 100) | false |
Example request
curl --location 'https://api.vendy.money/transactions?businessId=1&limit=0, 100' \
--header 'Authorization: Bearer <token>'
Response:
Field | Type | Description |
---|---|---|
status | Boolean | States if request was successfully executed or not |
code | Integer | Internal code, success if 200 |
msg | String | A description of the status of the request |
data | Array[Transaction] | All retrieved transaction details |
Example response
{
"status": true,
"code": 200,
"msg": "Transactions",
"data": [
{
"id": 1,
"uid": 1,
"businessId": 1,
"request": "Optional",
"msisdn": "08101851915",
"amount": "100.0000",
"requestamount": "100.0000",
"refid": "6518564956061343757",
"vendref": null,
"debitref": "6518564956061343757",
"reason": "success",
"raw_reason": "success",
"channel": "ussd",
"page": "pin-page",
"currency": "NGA",
"delivered":1,
"vended": 1,
"reversed": 0,
"debited": 1,
"failed": 0,
"isreversing": 0,
"processing": 0,
"flag": null,
"created_on": "2021-10-31T21:58:27.000Z",
"updated_on": "2021-10-31T21:59:27.000Z",
"delivered_date":"2021-10-31T21:59:27.000Z",
"reversed_date": null,
"meta": {
"fee": 0.5,
"commission":0.5
}
},
{
"id": 2,
"uid": 1,
"businessId": 1,
"request": "Optional",
"msisdn": "08101851915",
"amount": "100.0000",
"requestamount": "100.0000",
"refid": "6518564956061343757",
"vendref": null,
"debitref": "6518564956061343757",
"reason": "success",
"raw_reason": "success",
"channel": "ussd",
"page": "pin-page",
"currency": "NGA",
"delivered":1,
"vended": 1,
"reversed": 0,
"debited": 1,
"failed": 0,
"isreversing": 0,
"processing": 0,
"flag": null,
"created_on": "2021-10-31T21:58:27.000Z",
"updated_on": "2021-10-31T21:59:27.000Z",
"delivered_date":"2021-10-31T21:59:27.000Z",
"reversed_date": null,
"meta": {
"fee": 0.5,
"commission":0.5
}
}
]
}
Possible errors:
Error code | Type | Description |
---|---|---|
204 | INVALID_DATA | Data is invalid |