---
title: "Get Transactions"
method: GET
path: "/reporting/financial-data/transactions"
---

# Get Transactions

`GET /reporting/financial-data/transactions`

Retrieves transaction data for a given time period.

## Query parameters

- `startDate` string, date-time, required
- `endDate` string, date-time, required
- `limit` integer
- `sortDirection` 'asc' | 'desc'

## Headers

- `x-publisher-token` string, required

## Response `200`

Successfully retrieved transactions.

- object
  - `totalCount` integer — Total number of transactions matching the query.
  - `nextCursor` string — Cursor pointing to the next page of results.
  - `nextPageQuery` string — Fully-formed query string for fetching the next page of results.
  - `results` Transaction[] — List of transaction results returned by the query.
    - `orderId` string — Order ID.
    - `purchaseId` string — Purchase ID.
    - `publisherTransactionId` string — Transaction ID.
    - `timestamp` string, date-time — Transaction timestamp in [UTC ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `customerDetails` object — Customer information.
      - `id` string — Customer ID.
      - `email` string — Customer email address.
    - `geolocation` object — Geolocation information.
      - `countryCode2` string — Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. Required if `playerIp` is not provided. Example: `US`.
      - `playerIp` string — Player IP address in [IPv4](https://en.wikipedia.org/wiki/IPv4) format. Required if `countryCode2` is not provided. Example: `192.0.2.1`.
      - `region` string — Region or state.
      - `ipAddress` string — IP address.
      - `zipCode` string — Postal code.
    - `offerDetails` object — Offer information.
      - `offerId` string — Offer ID.
      - `offerName` string — Offer name.
      - `type` string — Offer type.
      - `products` object[] — List of products in the offer.
        - `name` string — Product name.
        - `sku` string — Product SKU.
        - `quantity` number — Product quantity.
    - `transactionDetails` object — Transaction information.
      - `id` string — Transaction ID.
      - `type` 'paid' | 'refund' | 'dispute_funds_withdrawn' | 'dispute_funds_reinstated' — Transaction type.
      - `amount` number — Transaction amount in the local currency's smallest unit. For example, if the amount is $9.99, the API returns `999`, not `9.99`. For currencies with no subunit, such as JPY, the value represents the full unit. See [Supported Currencies](/../../merchant-of-record/finance/supported-currencies) for per-currency decimal rules.
      - `amountUsd` number — Transaction amount in USD cents. For example, `999` means $9.99, not $999.
      - `totalTaxAmount` number — Total tax amount in the local currency's smallest unit. For example, if the tax is $0.90, the API returns `90`, not `0.90`. For currencies with no subunit, such as JPY, the value represents the full unit. See [Supported Currencies](/../../merchant-of-record/finance/supported-currencies) for per-currency decimal rules.
      - `totalTaxAmountUsd` number — Total tax amount in USD cents.
      - `currencyExchangeCostUsd` number — Currency exchange cost in USD cents.
      - `chargebackFeeUsd` number — Chargeback fee in USD cents.
      - `transactionFeeUsd` number — Transaction fee in USD cents.
      - `publisherNetAmountUsd` number — Publisher net amount in USD cents.
      - `currencyCode` string — Currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format.
      - `currencySymbol` string — Currency symbol.
      - `paymentMethod` string — Payment method used.

## Other responses

- `400` — Bad request - invalid parameters.
- `401` — Unauthorized - authentication failed.
- `500` — Internal server error.

---

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