---
title: "List Customer Transactions"
method: GET
path: "/v2/transactions"
tags: ["Transactions"]
---

# List Customer Transactions

`GET /v2/transactions`

Returns a paginated list of transactions for a customer, optionally filtered by transaction type.

## Query parameters

- `customer_id` string, required
- `type` 'ONRAMP' | 'OFFRAMP' | 'CRYPTO_WITHDRAWAL' | 'CRYPTO_DEPOSIT'
- `current_page` integer
- `per_page` integer

## Response `200`

Transactions retrieved successfully

- object
  - `data` object
    - `pagination` object
      - `current_page` integer
      - `per_page` integer
      - `total_page` integer
      - `total` integer
    - `transactions` object[]
      - `id` string, uuid
      - `transaction_type` 'ONRAMP' | 'OFFRAMP' | 'CRYPTO_WITHDRAWAL' | 'CRYPTO_DEPOSIT'
      - `customer_id` string, uuid
      - `beneficiary_id` string, uuid
      - `hash` string — On-chain transaction hash.
      - `status` string
      - `source_currency` string
      - `destination_currency` string
      - `source_amount` number
      - `destination_amount` number
      - `total_fee` number
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `401` — Authentication failed due to invalid credentials
- `422` — Failed due to a formatting error.

---

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