Get Bulk Transactions

Returns recent transactions across up to 100 connected users in one call — at most 20 per target, newest first, defaulting to the last 90 days.

Requirements

Authorization: Basic <API_KEY> (your application API key)
The bulk API capability on your application
The LIST_PAYMENT and LIST_PURCHASES scopes on each target user’s grant

Failures are reported per target and never fail the whole request. See Bulk API Overview for the targeting model and error codes.

Query

query GetBulkTransactions(
  $targetSpec: BulkTargetSpecInput!
  $createdGte: DateTime
  $createdLte: DateTime
  $includeMetadata: Boolean
) {
  getBulkTransactions(
    targetSpec: $targetSpec
    createdGte: $createdGte
    createdLte: $createdLte
    includeMetadata: $includeMetadata
  ) {
    targetCount
    successCount
    failureCount
    results {
      externalReferenceId
      accountId
      success
      error { code message }
      totalCount
      hasNextPage
      transactions {
        recordId
        transactionType
        amount
        status
        createdAt
        memo
        transactionCategory
      }
    }
  }
}

Variables

{
  "targetSpec": { "mode": "SELECTED", "targets": ["your-user-001"] },
  "createdGte": null,
  "createdLte": null,
  "includeMetadata": false
}

Response

{
  "data": {
    "getBulkTransactions": {
      "targetCount": 1,
      "successCount": 1,
      "failureCount": 0,
      "results": [
        {
          "externalReferenceId": "your-user-001",
          "accountId": "8f3c…",
          "success": true,
          "error": null,
          "totalCount": 42,
          "hasNextPage": true,
          "transactions": [
            {
              "recordId": "rec-1",
              "transactionType": "GIFT_CARD_PURCHASE",
              "amount": 25.0,
              "status": "SETTLED",
              "createdAt": "2026-07-01T00:00:00.000Z",
              "memo": null,
              "transactionCategory": null
            }
          ]
        }
      ]
    }
  }
}

Arguments

Argument	Type	Description
`targetSpec`	`BulkTargetSpecInput!`	Target selection. Max 100 targets. See Overview.
`createdGte`	`DateTime`	Only include transactions created at/after this time. Defaults to 90 days before `createdLte`.
`createdLte`	`DateTime`	Only include transactions created at/before this time. Defaults to now.
`includeMetadata`	`Boolean`	Also return `memo` and `transactionCategory`. Slower; defaults to `false`.

Response fields

Field	Description
`results[].transactions`	Up to 20 most-recent transactions in the window, newest first. Restricted to permitted spend accounts when the grant is spend-account-scoped.
`results[].totalCount`	Total transactions matching the window for this target.
`results[].hasNextPage`	`true` when the target has more than the 20 returned.
`targetCount` / `successCount` / `failureCount`	Request-level summary.

Limits & getting complete history

20 transactions per target and a maximum 90-day window per request. A window wider than 90 days is rejected — narrow the range or use the export.
When hasNextPage is true or totalCount exceeds what’s returned, there’s more data. This bounded query never silently truncates; for complete history use the asynchronous transactions export (coming soon).
includeMetadata: true adds memo and transactionCategory per transaction at some latency cost. Attachment links aren’t included on the bulk path — use the export for full metadata.

​Requirements

​Query

​Variables

​Response

​Arguments

​Response fields

​Limits & getting complete history