---
title: "Order Transactions"
method: GET
path: "/api/v4.0/integrations/orders/{orderId}/transactions"
tags: ["Orders"]
---

# Order Transactions

`GET /api/v4.0/integrations/orders/{orderId}/transactions`

This API retrieves the transactional details for a specified order in Gameball, identified by `orderId`. It includes information on rewards, refunds, and equivalent points, giving a detailed view of the financial activities associated with the order.

**Security:** Requires both `apikey` and `secretkey` headers.

## Path parameters

- `orderId` string, required

## Response `200`

Order transactions retrieved successfully

- object
  - `transactions` object[] — List of transactions associated with the order. **Example:** If a customer places an order and redeems points, the transactions array will contain both the cashback reward transaction and the redemption transaction.
    - `transactionDate` string, date-time — The date and time when the transaction occurred.
    - `gameballTransactionId` integer — Unique identifier for the transaction in the Gameball system.
    - `transactionType` 'AchievementReward' | 'PaymentReward' | 'Payment' | 'Refund' | 'PartialRefund' | 'Redemption' | 'Expiry' | 'Cancel' | 'Migration' | 'ManualAccumulation' | 'DiscountCode' | 'ManualDeduction' | 'ManualReward' — Type of transaction. Possible values include: **AchievementReward** - Captured when a customer reaches a VIP tier, participates in a reward campaign, or makes a referral. **PaymentReward** - Recorded for rewarding a customer with points for every placed order. **Payment** - Recorded when a customer makes a payment for an order. **Refund** - Captured when points redeemed from a refunded order are returned to the customer. **PartialRefund** - Captured when a partial refund is processed, returning a portion of redeemed points to the customer. **Redemption** - Recorded whenever a customer redeems their points for rewards. **Expiry** - Captured when a customer's points expire, indicating a reduction in their total points. **Cancel** - Recorded when a customer cancels an order, leading to the deduction of rewarded points. **Migration** - Captured during updates or migrations of customer data via a CSV file, reflecting added or deducted points. **ManualAccumulation** - Recorded for points that are manually added to a customer's balance. **DiscountCode** - Captured when a customer creates a coupon code. **ManualDeduction** - Recorded for points manually removed from a customer's balance. **ManualReward** - Similar to AchievementReward, but specifically for manually awarding achievements to a customer.
    - `amount` number — The monetary value involved in the transaction.
    - `transactionId` string — A unique identifier for a transaction in your system (e.g., order number or invoice number). This ID can be used to reverse, cancel, or refund any reward or redemption transactions in Gameball.
    - `equivalentPoints` number — The points equivalent to the monetary value of the transaction.
  - `count` integer — Total number of transactions associated with the order.

## Changes

- **2026-02-09** `3f15cf633b76` — 2 warning
  - added the new `PartialRefund` enum value to the `transactions/items/transactionType` response property for the response status `200`
  - added the new `Payment` enum value to the `transactions/items/transactionType` response property for the response status `200`
- **2025-12-17** `262228c13429` — 3 info
  - the endpoint scheme security `apiKey AND secretKey` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - the endpoint scheme security `secretKey` was removed from the API
- **2025-09-18** `5a5238b642e9` — 11 warning, 2 info
  - added the new `AchievementReward` enum value to the `transactions/items/transactionType` response property for the response status `200`
  - added the new `Cancel` enum value to the `transactions/items/transactionType` response property for the response status `200`
  - added the new `DiscountCode` enum value to the `transactions/items/transactionType` response property for the response status `200`
  - added the new `Expiry` enum value to the `transactions/items/transactionType` response property for the response status `200`
  - …9 more
- **2025-09-10** `95e7f65e5afd` — 1 info
  - endpoint added
- **2025-09-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/orders/:orderId/transactions/get.md)

---

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