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

# List fiat transaction statuses

`GET /payments/status`

Retrieves fiat transaction status objects for the calling platform. Defaults: when `start_date`/`end_date` are omitted, the last day of transactions is returned; when `page`/`size` are omitted, the first 200 transactions are returned; omitting `participant` or `status` removes the respective filter.

## Query parameters

- `start_date` integer
- `end_date` integer
- `participant` string
- `transaction_id` string
- `trade_id` string
- `status` 'posted' | 'cancelled' | 'failed' | 'returned' | 'submitted' | 'pending' | 'settled' | 'rejected' | 'pending_trade' | 'returned_settled' | 'retried' | 'unspecified'
- `page` number
- `size` number

## Headers

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

## Response `200`

Successfully retrieved paginated list of fiat transaction statuses with optional filters: start_date, end_date, participant, transaction_id, trade_id, status.

- GetACHTransactionStatusResponse
  - `request_id` string, uuid — Request identifier echoed back from the request.
  - `message` ACHTransactionStatus[]
    - `transaction_id` string — Transaction id
    - `participant_code` string — Participant code
    - `amount` string — Transaction amount
    - `status` 'posted' | 'cancelled' | 'failed' | 'returned' | 'submitted' | 'pending' | 'settled' | 'rejected' | 'pending_trade' | 'returned_settled' | 'retried' | 'unspecified' — transaction status
    - `transfer_type` 'credit' | 'debit' | 'unspecified' — transfer type
    - `bank_transfer_id` string — Bank transfer id
    - `trade_id` string — Trade id
    - `trade_status` string — Trade status
    - `velocity_status` 'pending' | 'approved' | 'rejected' — Status of velocity checks
    - `velocity_failed_rule` string — If velocity_status = rejected, the rule that failed
    - `ach_failure_reason` string — Failure reason
    - `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)