---
title: "Get user points history"
method: GET
path: "/v1/points/history"
tags: ["Points (User)"]
---

# Get user points history

`GET /v1/points/history`

## Query parameters

- `verbosity` number

## Response `200`

User points history retrieved successfully

- HistoryResponse
  - `state` 'LIQUID' | 'FROZEN' | 'SENDING' | 'SENT' | 'SPENT' — Current state of the balance.
  - `type` 'VOUCHER' | 'UTXO' | 'GIFT_CARD' | 'PREPAID_CARD' | 'UTILITY_TOKEN' — Type of balance.
  - `currency` string — The currency of the transaction.
  - `txes` Transaction[] — List of transactions.
    - `txid` string — Unique identifier of the transaction.
    - `amount` number — Amount involved in the transaction.
    - `direction` 'income' | 'outcome' — Direction of the transaction.
    - `type` string — Type of the transaction.
    - `timestamp` string, date-time — Timestamp of the transaction.
    - `from` string, uuid, nullable — Source of the transaction. Can be null.
    - `to` string, uuid — Destination of the transaction.

---

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