---
title: "Gets Transaction Pagination"
method: GET
path: "/programs/{programCode}/accounts/{accountIdentifier}/transactions/pagination"
tags: ["Transactions"]
---

# Gets Transaction Pagination

`GET /programs/{programCode}/accounts/{accountIdentifier}/transactions/pagination`

Retrieves a paginated list of transactions for the specified account, allowing clients to page through large sets of transaction data.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `purseIdentifier` string

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- GetTransactionPaginationResponse — Represents the response for a paginated transaction list request.
  - `pagination` Pagination — Contains pagination information for paginated API responses.
    - `offset` integer — The zero-based index of the first item returned in the current page.
    - `limit` integer — The maximum number of items that can be returned in a single page.
    - `firstPage` boolean — Indicates whether the current page is the first page in the result set.
    - `lastPage` boolean — Indicates whether the current page is the last page in the result set.
  - `transactions` GetTransactions[], nullable — List of transactions returned by the query.
    - `userIdentifier` string, nullable — Unique identifier for the user associated with the transaction.
    - `paymentIdentifier` string, nullable — Unique identifier for the payment associated with the transaction.
    - `transactionIdentifier` string, nullable — Unique identifier for the transaction.
    - `parentTransactionIdentifier` string, nullable — Identifier of the parent transaction.
    - `transactionType` string, nullable — The type of transaction.
    - `transactionTypeDescription` string, nullable — Human-readable description of the transaction type.
    - `transactionStatus` string, nullable — The status of the transaction.
    - `accountIdentifier` string, nullable — Unique identifier for the account associated with the transaction.
    - `purseIdentifier` string, nullable — Unique identifier for the purse associated with the transaction.
    - `bin` string, nullable — Bank Identification Number (BIN) associated with the card used in the transaction.
    - `last4Pan` string, nullable — Last four digits of the Primary Account Number (PAN) used in the transaction.
    - `currency` string, nullable — Represents the currency code for the transaction.
    - `postedDateTime` string, nullable — Date and time when the transaction was posted.
    - `transactionAmount` number, double — The amount of the transaction.
    - `fee` Fee — Represents a fee applied to a transaction or account operation. Contains details such as the fee identifier, type, description, amount, currency, frequency, and localized display name. Used to provide transparency about costs associated with transfers, account actions, or other financial operations.
      - `identifier` string, nullable — The unique identifier for the fee, used for tracking and reference.
      - `feeType` string, nullable — The type of fee (e.g., "transaction", "service", "maintenance").
      - `description` string, nullable — A human-readable description of the fee, explaining its purpose or context.
      - `amount` number, double — The monetary amount of the fee.
      - `currency` string, nullable — The ISO 4217 currency code for the fee amount (e.g., "USD").
      - `frequency` string, nullable — The frequency with which the fee is applied (e.g., "one-time", "monthly", "annual").
      - `localizedDisplayName` string, nullable — The localized display name for the fee, used for UI presentation in different languages or regions.
    - `isCredit` boolean — Indicates whether the transaction is a credit (true) or other type of transaction (false).
    - `networkTransactionData` NetworkTransactionData — Represents network-specific transaction data, such as merchant, authorization, and card network details.
      - `authorizationDateTime` string, nullable — The date and time when the transaction was authorize.
      - `cashBackAmount` number, double — The amount of cash back provided as part of the transaction.
      - `localTransactionData` LocalTransactionData — Represents the data for a local transaction, including the amount and currency.
        - `amount` number, double — Gets or sets the amount of the transaction.
        - `currency` string, nullable — Gets or sets the currency code for the transaction.
      - `cardAcceptor` CardAcceptor — Represents the card acceptor involved in a transaction.
        - `merchantId` string, nullable — Unique identifier assigned to the merchant.
        - `merchantName` string, nullable — The name of the merchant where the transaction occurred.
        - `merchantIndustryCode` string, nullable — The industry code assigned to the merchant.
        - `merchantIndustryCategory` string, nullable — The industry category of the merchant.
        - `merchantIndustryDescription` string, nullable — Human-readable description of the merchant's industry.
        - `addressLine1` string, nullable — The first line of the merchant's address.
        - `city` string, nullable — The city where the merchant is located.
        - `postalCode` string, nullable — The postal or ZIP code of the merchant's location.
        - `stateProvReg` string, nullable — The state, province, or region of the merchant's address.
        - `country` string, nullable — The country where the merchant is located.
      - `merchantCategory` string, nullable — The merchant category for the transaction.
      - `merchantCategoryCode` string, nullable — The merchant category code (MCC) for the transaction.
      - `networkName` string, nullable — The name of the card network that processed the transaction (e.g., "Visa", "Mastercard").
      - `authorizedTransactionData` AuthorizedTransactionData — Represents additional authorization data for a transaction.
        - `authStatusIndicator` string, nullable — Indicator of the authorization status for the transaction.
        - `authorizationResponseCode` string, nullable — The response code returned by the issuer or network for the authorization request.
        - `holdExpirationDate` string, nullable — The date and time when the authorization hold will expire.
        - `declineReason` string, nullable — The reason for decline if the authorization was not approved.
    - `postedInternalTransactionData` PostedInternalTransactionData — Represents internal transaction data for posted transactions.
      - `transferIdentifier` string, nullable — Unique identifier for the transfer associated with this transaction.
      - `adjustmentIdentifier` string, nullable — Unique identifier for the adjustment associated with this transaction.
      - `achCategoryCode` string, nullable — ACH category code for the transaction.
      - `adjustmentType` string, nullable — The type of adjustment applied to the transaction.
      - `transactionDescriptionData` object, nullable — Additional transaction description data as key-value pairs.
      - `description` string, nullable — Human-readable description of the transaction.
      - `bankData` BankAccount — Container for bank account details.
        - `routingNumber` string, nullable — External bank routing number.
        - `accountNumber` string, nullable — External bank account number.
        - `bankName` string, nullable — External bank name.
        - `firstName` string, nullable — Customer first name.
        - `lastName` string, nullable — Customer last name.
        - `accountType` string, nullable — External bank account type.
        - `businessName` string, nullable — Business name.
      - `retailSaleData` RetailSaleData — Represents retail sale data associated with a transaction.
        - `merchantName` string, nullable — The name of the merchant where the retail sale occurred.
        - `storeNumber` string, nullable — The store number or identifier for the specific retail location.
        - `city` string, nullable — The city where the retail sale took place.
        - `state` string, nullable — The state or province where the retail sale took place.
      - `transferType` 'None' | 'DisbursementIn' | 'DisbursementOut' | 'AchOut' | 'PurseTransfer' | 'SwipeReload' | 'Adjustment' | 'AchPull' | 'PeerTransfer' | 'Mrdc' | 'ECashLoad' | 'BillPay' | 'ECashSend' | 'EGiftPurchase' | 'IftSend' | 'IftLoad' | 'IftOut' | 'WireOut' | 'SCCPayment' | 'SCCFunding' | 'CreditLineIncrease' | 'CreditLineDecrease' | 'SccOverCreditLimit' | 'SccWriteOffFullBalance' | 'SccWriteOffPartialBalance' | 'SccWriteOffNegativeBalance' | 'SccPaymentByAchPull' | 'CblPayment' | 'CblRefund' | 'SccWriteOffOverCreditLimit' | 'UnLoad' | 'InitialLoad' | 'SCCWriteOffNegativeBalanceOnly' | 'AffiliateTransfer' — The type of fund transfer for the transaction.
      - `partnerAdjustmentType` string, nullable — The partner-specific adjustment type, if applicable.
    - `retrievalReferenceNumber` string, nullable — Retrieval reference number for the transaction.
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/versions/666553766b78/schema)
