---
title: "All Users' Transactions history"
method: GET
path: "/payout/user/history"
tags: ["User"]
---

# All Users' Transactions history

`GET /payout/user/history`

This **GET** endpoint is used to retrieve a list of all transactions, including payouts, loads, and spendbacks, for all users. <br> You can use this endpoint to obtain a comprehensive history of transactions for all users, allowing you to track and analyze their payment activities over time. <br> The response will contain a JSON array of transaction objects, each including transactions details.

## Query parameters

- `number_of_records` number
- `start_date` string, date
- `end_date` string, date
- `page` integer
- `type` 'payout' | 'load' | 'spendback' | 'payin'
- `wallet_token` string, uuid
- `show_all_clients` boolean

## Headers

- `Idempotency-Key` string

## Response `200`

Succesful operation.

- TxnHistoryRecordResp[]
  - `token` string, uuid, required — Token represnting the transaction
  - `type` 'load' | 'payout' | 'spend back' | 'info' | 'payin', required — Type of transaction
  - `time_of_txn` string, date-time, required — Time the transaction was created. In UTC
  - `source_amount` number, float, required — Source amount
  - `source_currency_code` string, required — The currency originating balance is stored in. Using [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. In most cases this value will be USD, and therefore the defaut value if none is provided
  - `destination_amount` number, float, required — The amount that was received in `destination_currency_code`
  - `destination_currency_code` string, required — The currency of the funds received. Using [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format
  - `fee` number, float, required — Fee of the transaction
  - `status` 'PENDING' | 'EXPIRED' | 'PROCESSING' | 'COMPLETED' | 'CANCELLED' | 'SCHEDULED' | 'READY_FOR_PICKUP' | 'HOLD' | 'ERROR' | 'CANCELLED_AT_LATER_TIME', required — Status of the transaction
  - `notes` string — Notes of the transaction when load or spend back
  - `payer_name` string — Name of the payer when payout transaction
  - `pickup_code` string — Code/pin that is required when collecting the money when payout transaction
  - `source_token` string, uuid — Token that represents the funding source i.e. bank account, wallet. 36 characters long
  - `destination_token` string, uuid, required — Token that represents the payout destination i.e. MassPay->Brazil->Bank Deposit->Itau. To be retrieved from the #pricing callback. If not provided, the last destination that was used for this user will be used. 36 characters long
  - `delivery_type` 'CASH_PICKUP' | 'BANK_DEPOSIT' | 'HOME_DELIVERY' | 'MOBILE_WALLET' | 'MASSPAY_CARD' | 'PAPER_CHECK' | 'BILL' | 'CRYPTOCURRENCY' — The type of service. I.e. cash pickup, home delivery, etc. Only provided for payouts
  - `client_transfer_id` string — A client defined transfer identifier. This is the unique ID assigned to the transfer on your system. Max 50 characters.
  - `status_reason` string — The reason for the status change. Usually would include reason for an ERROR or CANCEL status
  - `client_id` integer — Optional client id
  - `user_token` string — User token representing the user this transaction belongs to
  - `destination_country` string — 3 letters ISO code for destination country

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

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