Export Transactions

Download a paginated list of transactions filtered by type, status, date range, and currency. This endpoint is ideal for generating reports or displaying transaction histories without logging into your dashboard.

See Environments & Base URLs before making requests.

Endpoint

GET - {{baseurl}}/transaction

Header	Value
Authorization	Bearer YOUR_SECRET_KEY
Content-Type	application/json

Parameter	Type	Required	Description
transType	string	No	The type of transaction, for example conversion, settlement, collection, or transfer.
status	string	No	The current status, for example ongoing, pending, processing, verified, successful, failed, declined, initiated, reversed, expired, or abandoned.
startDate	string	No	Filter by start date (Format: YYYY-MM-DD).
endDate	string	No	Filter by end date (Format: YYYY-MM-DD).
currency	string	No	The 3-letter ISO currency code, for example NGN, USD, GHS, RWF, KES, TZS, UGX, XOF, XAF, ZAR, XAF, ZMW, GBP, USDT, or USDC.
skip	integer	No	The number of records to bypass
limit	integer	No	The max number of records to return

Sample request & sample response

Sample request:

Sample parameters

curl --location 'https://api.startbutton.tech/transaction?transType=transfer&status=successful&startDate=2026-05-01&endDate=2026-05-12&skip=1&limit=100&currency=NGN' \
--header 'Authorization: Bearer YOUR_SECRET_KEY'

Sample response:

The structure below is a standard representation. Actual fields may vary based on your account's specific transaction metadata.

{
    "success": true,
    "message": "transactions",
    "data": {
        "transactions": [
            {
                "rollingReserve": {
                    "isInReserve": true,
                    "amount": 5,
                    "reserveReleaseDate": "2026-11-07T21:48:04.724Z"
                },
                "merchantInfo": {
                    "name": "Test Company"
                },
                "_id": "6a024e942a67ecdd4de533b2",
                "transType": "collection",
                "status": "successful",
                "toAmount": 5000,
                "toCurrency": "NGN",
                "transactionReference": "000016260511224751001986031005",
                "customerEmail": "[e-mail]",
                "isRecurrent": false,
                "postProcess": null,
                "meta": {
                    "accountName": "EMMANUEL ISAAC EJIKEME",
                    "accountNumber": "2046665463",
                    "bankName": "FIRST BANK OF NIGERIA",
                    "narration": "FROM FBN/ EMMANUEL ISAAC EJIKEME-FIPMBEMMANUEL ISAAC EJISTART BUTTON LIMITED CHECKOUT NONESTART BUTTON LIMIT/000016260511224751001986031005",
                    "sessionId": "000016260511224751001986031005",
                    "paymentCollectionType": "UNDERPAYMENT",
                    "paymentChannel": "VA",
                    "existingTransaction": {
                        "reference": "0f854ce3303b",
                        "expectedAmount": 200
                    },
                    "customerActivity": {
                        "start_time": 1778535940468,
                        "time_spent": -2,
                        "attempts": 1,
                        "errors": 1,
                        "success": false,
                        "mobile": false,
                        "input": [],
                        "history": [
                            {
                                "type": "action",
                                "message": "Copied Virtual Account",
                                "time": null
                            },
                            {
                                "type": "action",
                                "message": "Attempted to complete transaction with Bank Transfer",
                                "time": null
                            },
                            {
                                "type": "error",
                                "message": "Error: Amount not up to specified amount!",
                                "time": null
                            }
                        ]
                    }
                },
                "customNotifyEmails": [],
                "isManual": false,
                "childTransactionIds": [],
                "source": null,
                "hasRollingReserve": true,
                "disputeReferences": [],
                "createdAt": "2026-05-11T21:48:04.668Z",
                "updatedAt": "2026-05-11T21:48:04.756Z",
                "feeAmount": 60,
                "paidAt": "2026-05-11T21:48:04.724Z",
                "toBalanceAfterAvailable": 2401166,
                "toBalanceAfterLedger": 2370802,
                "taxAmount": 0,
                "disputes": [],
                "id": "6a024e942a67ecdd4de533b2",
                "fromBalanceAfterLedger": 0,
                "fromBalanceAfterAvailable": 0
            }
        ],
        "total": 4777
    }
}