> For the complete documentation index, see [llms.txt](https://docs.switchappgo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.switchappgo.com/payments/transactions/list-transactions.md).

# List transactions

Retrieves a paginated list of your payment transactions.

{% hint style="info" %}
**NOTE:** This list contains all transactions including failed transactions. To get only successful transactions, filter using the transaction status query parameter.
{% endhint %}

{% openapi src="/files/D2OnIDDY2fzSVTk2AYNl" path="/v1/transactions" method="get" %}
[merchant-api-swagger-10-04-2023.json](https://163660187-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8qcR8TOKMHOvHEJFAJcO%2Fuploads%2Fz1Hkjfk2wl3pDM0TQvng%2Fmerchant-api-swagger-10-04-2023.json?alt=media\&token=79cc08f6-9596-401d-993c-32a29da7d56f)
{% endopenapi %}

{% tabs %}
{% tab title="curl" %}

```clike
curl -G https://api.switchappgo.com/v1/transactions \
    -H "authorization: 'bearer sk_test_nTgS42KNdKr6Ts798DT'" \
    -d page='3' \
```

{% endtab %}

{% tab title="node" %}

```javascript
const switchapp = require('switchapp')('sk_test_nTgS42KNdKr6Ts798DT');

const newTx = await switchapp.transactions.list({
    page: 3,
    pageSize: 150
})
```

{% endtab %}
{% endtabs %}