---
title: "List fiat transaction history"
method: GET
path: "/payments/history"
tags: ["Payments"]
---

# List fiat transaction history

`GET /payments/history`

Retrieves the historical fiat transactions (ACH / same-day ACH / wire / RTP) for the calling platform, with optional filters by participant, transfer type, or a set of transaction identifiers.

## Query parameters

- `participant` string
- `transaction_ids` string[]
- `transfer_type` 'credit' | 'debit'
- `page` number
- `size` number

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved paginated list of fiat transactions with optional filters: participant, transfer_type.

- GetACHTransactionHistoryResponse
  - `request_id` string, uuid — Request identifier echoed back from the request.
  - `message` ACHTransactionHistory[]
    - `transaction_id` string — Transaction id
    - `participant_code` string — Participant code
    - `external_account_id` string — External account id
    - `amount` string — Transaction amount
    - `bank_fee` string — Bank fee
    - `network` 'ach' | 'same_day_ach' | 'wire' | 'unspecified' | 'rtp' — Network type
    - `transfer_type` 'credit' | 'debit' | 'unspecified' — Transfer type
    - `status_history` ACHStatus[]
      - `status` 'posted' | 'cancelled' | 'failed' | 'returned' | 'submitted' | 'pending' | 'settled' | 'rejected' | 'pending_trade' | 'returned_settled' | 'retried' | 'unspecified' — transaction status
      - `timestamp` string — Status update timestamp
    - `trade_id` string — Trade id
    - `bank_transfer_id` string — Bank transfer id
    - `created_at` string — Created at date with time
    - `updated_at` string — Updated at date with time
  - `page` number
  - `page_size` number
  - `count` number

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)