# List transactions

List transactions scoped to your authenticated merchant, with supported filters and pagination.

Canonical: https://docs-firehorsepay.powerwebhub.com/api/list-transactions
Updated: 2026-11-22; API v1

## Request






## Example response






## Integration notes

Query parameters are excluded from the HMAC canonical path.

Use the returned pagination metadata; do not infer that one page is the complete transaction history.




## Endpoint

GET /api/v1/transactions

- type (query, optional): DEPOSIT, PAYOUT or REFUND.
- status (query, optional): Canonical transaction status.
- page / size (query, optional): Page index and page size.

### Node.js server example

```javascript
// Node.js 18+ · server only. No browser API key.
import { createHash, createHmac, randomUUID } from 'node:crypto';

const key = process.env.FIREHORSE_API_KEY;
if (!key) throw new Error('Set FIREHORSE_API_KEY on the server');
const path = '/api/v1/transactions';
const method = 'GET';
const body = '';
const timestamp = String(Math.floor(Date.now() / 1000));
const nonce = randomUUID();
const hash = createHash('sha256').update(body, 'utf8').digest('hex');
const canonical = [method, path.split('?')[0], timestamp, nonce, hash].join('\n');
const signature = createHmac('sha256', key).update(canonical).digest('hex');
const response = await fetch('https://firehorsepay.powerwebhub.com/transaction' + path, {
  method, redirect: 'error',
  headers: {
    'X-API-KEY': key, 'X-TIMESTAMP': timestamp,
    'X-NONCE': nonce, 'X-SIGNATURE': signature,
    'Content-Type': 'application/json'
  }
});
const result = await response.json();
if (!response.ok) {
  // Reconcile uncertain results and 409; do not blindly create another order.
  throw new Error('Firehorse HTTP ' + response.status);
}
// Store result securely. A 201/CREATED is not a confirmed payment.
```

### Example response (200)

```json
{
  "content": [
    {
      "id": 100123,
      "uuid": "6f1c0c8e-0d62-4a0f-a913-57c6e45d7c21",
      "type": "DEPOSIT",
      "status": "CREATED",
      "amount": 10,
      "currency": "EUR",
      "merchantReference": "order-example-001",
      "redirectUrl": null
    }
  ],
  "number": 0,
  "size": 20,
  "totalElements": 1
}
```
