> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/reference/export-transactions.md).

# 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](/startbutton-product-api/getting-started/environments-and-base-urls.md) before making requests.

{% tabs %}
{% tab title="Endpoint" %}
GET - `{{baseurl}}/transaction`
{% endtab %}
{% endtabs %}

| 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 [Available Currencies](/startbutton-product-api/reference/available-currencies.md#for-collections) including `GBP`, `USDT`, and `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:**

{% tabs %}
{% tab title="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'
```

{% endtab %}
{% endtabs %}

#### Sample response:

{% hint style="info" %}
The structure below is a standard representation. Actual fields may vary based on your account's specific transaction metadata.
{% endhint %}

```
{
    "success": true,
    "message": "transactions",
    "data": {
        "transactions": [
            {
                "rollingReserve": {
                    "isInReserve": true,
                    "amount": 5,
                    "reserveReleaseDate": "2026-11-07T21:48:04.724Z"
                },
                "merchantInfo": {
                    "name": "Test Company"
                },
                "_id": "6a024e942axxxxxxxxxx",
                "transType": "collection",
                "status": "successful",
                "toAmount": 5000,
                "toCurrency": "NGN",
                "transactionReference": "00001626051xxxxxxx",
                "customerEmail": "tester@gmail.com",
                "isRecurrent": false,
                "postProcess": null,
                "meta": {
                    "accountName": "JOHN DOE",
                    "accountNumber": "0123456789",
                    "bankName": "FIRST BANK OF NIGERIA",
                    "narration": "FROM FBN/ JOHN DOESTART BUTTON LIMITED CHECKOUT NONESTART BUTTON LIMIT/000016260511224751001986031005",
                    "sessionId": "000016260511xxxxxxx",
                    "paymentCollectionType": "UNDERPAYMENT",
                    "paymentChannel": "VA",
                    "existingTransaction": {
                        "reference": "0f854ce3xxxxx",
                        "expectedAmount": 200
                    },
                    "customerActivity": {
                       }
        ],
        "total": 
    }
}
```