---
title: "Get Payment History"
method: GET
path: "/api/v1/payment/payment-history"
tags: ["Payment"]
---

# Get Payment History

`GET /api/v1/payment/payment-history`

Get payment history with filter criteria.

## Request body

- PaymentHistoryDto
  - `page` number — To indicate current page of the listing
  - `limit` number — To indicate number of records return for single page.
  - `orderBy` string — field name
  - `orderSequence` number — 1 - ASC, -1 - DESC, 0 - No sort
  - `txType` 'Buy' | 'Sell' — Transaction Types, 'Buy', 'Sell'
  - `network` string — CryptoCurrency network that you would allow your customers to buy/sell. You can get the network name from GET /crypto-currencies. Example: 'mainnet', 'ethereum', 'bep2', 'matic'
  - `emailAddress` string — Securo user email address created by your account
  - `paymentMethod` string — Payment method. You can get the payment method id from GET /fiat-currencies. Example: 'upi', 'credit_debit_card', 'gbp_bank_transfer'
  - `walletAddress` string — The blockchain address of the user's wallet that the purchased cryptocurrency will be sent to.
  - `fiatCurrency` string — The code of the fiat currency you want the customer to buy/sell cryptocurrency. You can get the symbol from GET /fiat-currencies. Example: 'INR', 'EUR', 'USD'.
  - `cryptoCurrency` string — Crypto currency symbol that you would allow your customers to buy/sell. You can get the symbol from GET /crypto-currencies. Example: 'ETH', 'BTC', 'DAI'.
  - `status` string[] — Payment statuses in array
  - `fromDate` number, required — Format is Unix timestamp in milliseconds
  - `toDate` number, required — Format is Unix timestamp in milliseconds

## Response `200`

Payment history is found.

- PaymentDetailsResponseListVo
  - `statusCode` number
  - `message` string
  - `data` PaymentDetailsVo[]
    - `invoiceId` string — Unique identifier of invoice
    - `totalFees` number — Total transaction fees
    - `cryptoCurrency` string — Cryptocurrency symbol for the transaction
    - `fiatCurrency` string — Fiat currency symbol for the transaction
    - `paymentMethod` string — Payment method used for the transaction
    - `paymentStatus` string — Payment status, value is `pending`, `success`, `failed`, `void`
    - `orderStatus` string — Order status from payment provider
    - `isBuyOrSell` string — Indicate the transaction either is `BUY` or `SELL`
    - `tax` number — Tax amount for the transaction
    - `blockchainNetwork` string — Blockchain network name
    - `exchangeRate` number — Conversion rate
    - `fiatAmount` number — Fiat amount for the transaction
    - `cryptoAmount` number — Cryptocurrency amount for the transaction
    - `expiredDate` string — Expire date of the payment request
    - `createdAt` string — Timestamp of payment request created in milliseconds
    - `createdDate` string — Date of payment request created
    - `paymentProvider` string — Payment provider name
    - `walletAddress` string — Wallet address is used for the transaction
    - `user` object
      - `emailAddress` string
      - `firstName` string
      - `lastName` string
      - `mobileNumber` string
      - `dateOfBirth` string
      - `street` string
      - `city` string
      - `state` string
      - `country` string
      - `postalCode` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden Resources

---

[API](https://skmtc.dev/securo/apis/securo-api.md) · [All operations](https://skmtc.dev/securo/apis/securo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/securo/securo-api/revisions/6cdab218fa72/schema)