Skip to main content
GET
/
reporting
/
financial-data
/
transactions
curl -X GET \
  'https://api.appcharge.com/reporting/financial-data/transactions?startDate=2025-05-26T00:00:00Z&endDate=2025-07-24T23:59:59Z&limit=100&sortDirection=asc' \
  -H 'x-publisher-token: <x-publisher-token>'

{
  "totalCount": 245,
  "nextCursor": "eyJpZCI6IjY0YzkidQ==",
  "nextPageQuery": "?startDate=2025-05-26T00:00:00Z&endDate=2025-07-24T23:59:59Z&limit=100&sortDirection=asc&cursor=eyJpZCI6IjY0YzkidQ==",
  "results": [
    {
      "orderId": "ac_order_98f3pb4",
      "purchaseId": "pr-1234-5678-9012-34567",
      "publisherTransactionId": "ca-9832-custom",
      "timestamp": "2025-05-26T14:30:00.000Z",
      "customerDetails": {
        "id": "jane-doe",
        "email": "jan.doe@example.com"
      },
      "geolocation": {
        "countryCode2": "US",
        "region": "CA",
        "ipAddress": "192.168.1.10",
        "zipCode": "94107"
      },
      "offerDetails": {
        "offerId": "offer_7890",
        "offerName": "Gem Pack",
        "type": "Bundle",
        "products": [
          {
            "name": "Gems",
            "sku": "gems_100",
            "quantity": 100
          }
        ]
      },
      "transactionDetails": {
        "id": "64c9f6a12e1b4a3d9c7a5f1ef",
        "type": "paid",
        "amount": 9.99,
        "amountUsd": 9.99,
        "totalTaxAmount": 0.9,
        "totalTaxAmountUsd": 0.9,
        "currencyExchangeCostUsd": 0.15,
        "chargebackFeeUsd": 0,
        "transactionFeeUsd": 0.35,
        "publisherNetAmountUsd": 8.59,
        "currencyCode": "USD",
        "currencySymbol": "$",
        "paymentMethod": "credit_card"
      }
    },
    {
      "orderId": "6981ddaac658821c7960ca0b",
      "purchaseId": "pr_9a9aaea0318d409ebb9afdc37df37a62",
      "publisherTransactionId": "123456789012",
      "timestamp": "2026-02-03T11:41:42.155Z",
      "customerDetails": {
        "id": "jim-jardashian",
        "email": "jim.jardashian@example.com"
      },
      "geolocation": {
        "countryCode2": "US",
        "region": "NY",
        "ipAddress": "192.168.1.11",
        "zipCode": "10025"
      },
      "offerDetails": {
        "offerId": "692ed6a00dffce88151a9575",
        "offerName": "Treasure Pack",
        "type": "Bundle",
        "products": [
          {
            "name": "Coins",
            "sku": "coins_555",
            "quantity": 55
          }
        ]
      },
      "transactionDetails": {
        "id": "6981def652cf42968c4ba2d3c",
        "type": "refund",
        "amount": -500,
        "amountUsd": -500,
        "totalTaxAmount": -76,
        "totalTaxAmountUsd": -76,
        "currencyExchangeCostUsd": 0,
        "chargebackFeeUsd": 0,
        "transactionFeeUsd": 55,
        "publisherNetAmountUsd": -424,
        "currencyCode": "USD",
        "currencySymbol": "$",
        "paymentMethod": "Credit Card"
      }
    }
  ]
}

curl -X GET \
  'https://api.appcharge.com/reporting/financial-data/transactions?startDate=2025-05-26T00:00:00Z&endDate=2025-07-24T23:59:59Z&limit=100&sortDirection=asc' \
  -H 'x-publisher-token: <x-publisher-token>'

{
  "totalCount": 245,
  "nextCursor": "eyJpZCI6IjY0YzkidQ==",
  "nextPageQuery": "?startDate=2025-05-26T00:00:00Z&endDate=2025-07-24T23:59:59Z&limit=100&sortDirection=asc&cursor=eyJpZCI6IjY0YzkidQ==",
  "results": [
    {
      "orderId": "ac_order_98f3pb4",
      "purchaseId": "pr-1234-5678-9012-34567",
      "publisherTransactionId": "ca-9832-custom",
      "timestamp": "2025-05-26T14:30:00.000Z",
      "customerDetails": {
        "id": "jane-doe",
        "email": "jan.doe@example.com"
      },
      "geolocation": {
        "countryCode2": "US",
        "region": "CA",
        "ipAddress": "192.168.1.10",
        "zipCode": "94107"
      },
      "offerDetails": {
        "offerId": "offer_7890",
        "offerName": "Gem Pack",
        "type": "Bundle",
        "products": [
          {
            "name": "Gems",
            "sku": "gems_100",
            "quantity": 100
          }
        ]
      },
      "transactionDetails": {
        "id": "64c9f6a12e1b4a3d9c7a5f1ef",
        "type": "paid",
        "amount": 9.99,
        "amountUsd": 9.99,
        "totalTaxAmount": 0.9,
        "totalTaxAmountUsd": 0.9,
        "currencyExchangeCostUsd": 0.15,
        "chargebackFeeUsd": 0,
        "transactionFeeUsd": 0.35,
        "publisherNetAmountUsd": 8.59,
        "currencyCode": "USD",
        "currencySymbol": "$",
        "paymentMethod": "credit_card"
      }
    },
    {
      "orderId": "6981ddaac658821c7960ca0b",
      "purchaseId": "pr_9a9aaea0318d409ebb9afdc37df37a62",
      "publisherTransactionId": "123456789012",
      "timestamp": "2026-02-03T11:41:42.155Z",
      "customerDetails": {
        "id": "jim-jardashian",
        "email": "jim.jardashian@example.com"
      },
      "geolocation": {
        "countryCode2": "US",
        "region": "NY",
        "ipAddress": "192.168.1.11",
        "zipCode": "10025"
      },
      "offerDetails": {
        "offerId": "692ed6a00dffce88151a9575",
        "offerName": "Treasure Pack",
        "type": "Bundle",
        "products": [
          {
            "name": "Coins",
            "sku": "coins_555",
            "quantity": 55
          }
        ]
      },
      "transactionDetails": {
        "id": "6981def652cf42968c4ba2d3c",
        "type": "refund",
        "amount": -500,
        "amountUsd": -500,
        "totalTaxAmount": -76,
        "totalTaxAmountUsd": -76,
        "currencyExchangeCostUsd": 0,
        "chargebackFeeUsd": 0,
        "transactionFeeUsd": 55,
        "publisherNetAmountUsd": -424,
        "currencyCode": "USD",
        "currencySymbol": "$",
        "paymentMethod": "Credit Card"
      }
    }
  ]
}

Headers

​
x-publisher-token
string
required

Publisher token.

Query Parameters

​
startDate
string<date-time>
required

Start date of the query in UTC ISO 8601 format.

Example:

"2025-05-26T00:00:00Z"

​
endDate
string<date-time>
required

End date of the query in UTC ISO 8601 format.

Example:

"2025-07-24T23:59:59Z"

​
limit
integer
default:10

Maximum number of transactions to return per page.

Min: 1 Max: 10,000

​
sortDirection
enum<string>
default:asc

Sort order of the results based on the timestamp field.

Available options:
asc,
desc

Response

Successfully retrieved transactions.

​
totalCount
integer

Total number of transactions matching the query.

Example:

"245"

​
nextCursor
string

Cursor pointing to the next page of results.

Example:

"eyJpZCI6IjY0YzkidQ=="

​
nextPageQuery
string

Fully-formed query string for fetching the next page of results.

Example:

"?startDate=2025-05-26T00:00:00Z&endDate=2025-07-24T23:59:59Z&limit=100&sortDirection=asc&cursor=eyJpZCI6IjY0YzkidQ=="

​
results
object[]

List of transaction results returned by the query.