---
title: "Get history of loads by user token"
method: GET
path: "/payout/load/{user_token}"
tags: ["Load"]
---

# Get history of loads by user token

`GET /payout/load/{user_token}`

This **GET** endpoint is used to retrieve a transaction history of all loads that were made to the provided user token, including scheduled loads. <br> You can use this endpoint to obtain a comprehensive history of loads for the user token, allowing you to track and analyze their incoming payments over time. <br> To use this endpoint, you need to provide the `user_token` as a parameter in the URL Path. <br> The endpoint will then return a JSON array of load transactions, each including transactions details.

## Path parameters

- `user_token` string, required

## Headers

- `Idempotency-Key` string

## Response `200`

Successful operation.

- Loads[]
  - `load_token` string, required — Token representing the load token
  - `time_of_load` string, YYYY-MM-DDThh:mm:ss, required — The timestamp the load was processed. If not processed yet, a future date will be returned. Using UTC timestamp.[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
  - `client_load_id` string, required — A client defined load identifier. This is the unique ID assigned to the load on your system. Max 50 characters.
  - `source_token` string, uuid, required — Token that represents the funding source i.e. bank account, wallet. 36 characters long
  - `wallet_token` string, uuid, required — Token that represents the wallet that received the funds. 36 characters long
  - `amount` number, required — The amount to credit the user's wallet in source currency
  - `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
  - `notes` string, required — A description for the load. Will be visible to the user receiving the load
  - `status` 'COMPLETED' | 'CANCELLED' | 'SCHEDULED', required — Status of the load
  - `metadata` object — Optional JSON object with attributes that can later be searched to locate this load. Do not include PII as this object is not encrypted.

## 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)