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.

Post a request to the URL below, where the base URL is determined by the environment you are in.

BaseUrl

Sandbox/PROD : https://api.startbutton.tech

Endpoint

GET - {{baseurl}}/transaction

Authorization	Set value to `Bearer null`
Content-type	Set value to application/json

When a customer clicks the payment action button on your website, ‘initialize a transaction’ by making a POST request to our API. Pass the email, amount, and other parameters to the initialize transaction endpoint. The table below lists the parameters that you can pass when initializing a transaction.

Parameter	Type	Required	Description
transType	string	No	The type of transaction (e.g., conversion, settlement, collection, transfer).
status	string	No	The current status (e.g., ongoing, pending, processing, verified, successful, failed, declined, initiated, reversed, expired, 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 (e.g., NGN, USD, GHS, RWF, KES, TZS, UGX, XOF, XAF, ZAR, XAF, ZMW, GBP, USDT, 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 null'

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
    }
}