---
title: "Get Transaction History"
method: GET
path: "/rewards/{site_id}/transactions"
tags: ["6. Rewards"]
---

# Get Transaction History

`GET /rewards/{site_id}/transactions`

Get history of transactions for the site. Requires an organisational bearer token.

## Path parameters

- `site_id` string, uuid, required

## Response `200`

Successful Response

- TransactionDataResponse — Response model for transaction history.
  - `site_id` string, uuid, required — ID of the site
  - `transactions` TransactionDatumResponse[], required — List of transactions for the site
    - `transaction_type` 'flex period' | 'flex period top-up' | 'flex event' | 'withdrawal' | 'invoice paid' | 'goodwill credit' | 'signup bonus' | 'correction' | 'VPP Signup Bonus' | 'Referred Credit' | 'Referrer Credit' | 'Recurring Referrer Credit' | 'FR SC Referred Credit' | 'FR SC Referrer Credit' | 'FR SC Signup Bonus' — An enumeration.
    - `transaction_id` string, uuid, required — ID of the transaction
    - `start_time` string, date-time — For transaction_type = 'flex event': when the event started For transaction_type = 'flex period': month start For transaction_type = 'withdrawal': when the withdrawal happened
    - `end_time` string, date-time — For transaction_type = 'flex event': when the event ended For transaction_type = 'flex period': month end Not present for other transaction_type values
    - `settlement_date` string, date — Date on which the transaction was settled, if known. For flex periods this is the payout date — the period start for in-advance payments and the period end for arrears payments. Clients should prefer this over start_time/end_time when displaying a single date for the transaction.
    - `flex_kwh` number — Stored to the nearest watt-hour (3dp) For transaction_type = 'flex event': the change in energy flow during the event relative to the baseline in kwh. +ve indicates additional energy imported (or less energy exported). -ve indicates additional energy exported (or less energy imported). Not present for other transaction_type values
    - `credit_pence` integer, required — Amount credited in pence
    - `payment_status` 'pending_approval' | 'approved' | 'processing' | 'posted' | 'failed' | 'rejected' | 'cancelled' | 'returned' — Payment lifecycle states
  - `is_below_withdrawal_minimum` boolean — If the user is below the minimum withdrawal threshold (if configured)
  - `days_until_minimum_wait_time_met` integer — How many days the user needs to wait to withdraw (if configured)

## Other responses

- `404` — Site not found or not authorized to access
- `422` — Validation Error
- `500` — Internal server error

---

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