---
title: "Public endpoint to get a list of Transactions for a validated program manager"
method: GET
path: "/api/v1/program-manager/transactions"
tags: ["Transactions"]
---

# Public endpoint to get a list of Transactions for a validated program manager

`GET /api/v1/program-manager/transactions`

## Request

- Base URL: `https://cardsapi-uat-pub.globalprocessing.net`
- URL: `https://cardsapi-uat-pub.globalprocessing.net/api/v1/program-manager/transactions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://uatists.globalprocessing.net/connect/token` scopes: `readWrite`

## Query parameters

- `PageSize` integer, required
- `PublicToken` string
- `ProductNames` string[]
- `FromDate` string, date-time, required
- `ToDate` string, date-time, required
- `TransactionCurrencyCodes` string[]
- `AmountMin` number, double
- `AmountMax` number, double
- `BillingCurrencyCodes` string[]
- `BillingAmountMin` number, double
- `BillingAmountMax` number, double
- `TraceIdLifeCycle` string
- `TransactionTypes` string[]
- `TransactionStatuses` string[]
- `ProcessingCodes` string[]
- `Location` string
- `Note` string
- `SortBy` 'Date' | 'Location' | 'Type' | 'Currency' | 'Amount', required
- `SortAscending` boolean, required
- `IsOfflineTransaction` boolean
- `PageNumber` integer, required

## Response `200`

Success

- ProgramManagerTransactionResponse[]
  - `id` integer: Transaction ID.
  - `description` string, nullable: Description.
  - `dateTime` string, date-time: Date and time.
  - `lifeCycleId` string, nullable: Lifecycle ID.
  - `type` TransactionType: wrapper class for transaction type as it comes back from the DAL
    - `code` string: Type of transaction (eg 'L' for load, 'U' for Unload).
    - `description` string, nullable: Description
  - `status` TransactionStatus: Transaction status
    - `code` string: Status of transaction.
    - `description` string, nullable: Description.
  - `amount` TransactionAmount: Transaction Amount
    - `billingValue` number, double: Billing Value
    - `billingCurrency` string, nullable: Billing Currency
    - `transactionValue` number, double: Transaction Value
    - `transactionCurrency` string, nullable: Transaction Currency
    - `settlementAmount` number, double, nullable: Settlement Amount
    - `settlementCurrency` string, nullable: SettlementCurrency
    - `actualBalance` number, double, nullable: Actual balance.
    - `availableBalance` number, double, nullable: Available balance.
  - `fees` TransactionFees: Transaction Fees
    - `id` integer: Transaction ID.
    - `fixedFee` number, double: Fixed fee.
    - `rateFee` number, double: Rate fee.
    - `fxPadding` number, double: FX padding.
    - `mccPadding` number, double: MCC padding.
  - `productId` integer, nullable: Product ID.
  - `cardNetwork` string, nullable: Card network.
  - `processingCode` string, nullable: Processing Code.
  - `recordId` integer: Record ID (may refer to a number of related entities).
  - `note` string, nullable: Processing Code.
  - `systemTraceAuditNumber` integer: System Trace Audit Number (STAN).
  - `transactionCountry` string, nullable: Transaction country.
  - `transactionLink` integer, nullable: ID of the related Transaction.
  - `additionalDetail` AdditionalDetail: Transaction additional details.
    - `acquirerForwarderId` string, nullable: Acquirer forwarder ID.
    - `authorisationExpiryDateUtc` string, date-time, nullable: Authorisation expiry date (UTC).
    - `authorisationType` string, nullable: Authorisation type.
    - `branchCode` string, nullable: Branch code.
    - `cardDeviceType` string, nullable: Card device type.
    - `checkResultsSent` string, nullable: Check results sent.
    - `checkResultsSentLocation` string, nullable: Check results sent location.
    - `currencyCodeFee` string, nullable: Currency code (Fee).
    - `currencyCodeFeeSettlement` string, nullable: Currency code (Fee settlement).
    - `dccIndicator` boolean, nullable: DCC indicator.
    - `emv` Emv: DTO describing smart card (EMV) data
      - `applicationTransactionCounter` integer, nullable: Transaction count
      - `cardholderVerificationCode` integer, nullable: Card Verification code
      - `cardholderVerificationResult` integer, nullable: Verification result
      - `terminalType` string, nullable: Terminal type
      - `terminalCapabilities` string, nullable: Terminal capabilities
      - `transactionCode` string, nullable: Transaction code
    - `fxRate` number, double, nullable: FOREX rate.
    - `instantFundingGPS` boolean, nullable: Instant funding GPS.
    - `instantFundingNetwork` boolean, nullable: Instant funding network.
    - `interchangeAmountFee` number, double, nullable: Interchange amount fee.
    - `interchangeAmountFeeSettlement` number, double, nullable: Interchange amount fee settlement.
    - `loadedBy` string, nullable: Loaded by.
    - `matchingTransactionId` integer, nullable: Matching transaction ID.
    - `merchant` Merchant: Merchant details of a submitted transaction.
      - `city` string, nullable: City.
      - `contact` string, nullable: Contact.
      - `county` string, nullable: County.
      - `name` string, nullable: Name.
      - `nameOther` string, nullable: Alternative name.
      - `networkId` string, nullable: Network ID.
      - `postcode` string, nullable: Post code.
      - `region` string, nullable: Region.
      - `street` string, nullable: Street.
      - `taxId` string, nullable: Tax ID.
      - `telephone` string, nullable: Telephone.
      - `url` string, nullable: Website url.
    - `multiPartCount` integer, nullable: Number of transactions in a multipart transaction.
    - `multiPartNumber` integer, nullable: Multipart number.
    - `multiPartTransaction` boolean, nullable: Whether the transaction is multipart.
    - `multiPartTransactionFinal` boolean, nullable: Multipart transaction final
    - `pos` Pos: Point of Sale data associated with a transaction.
      - `cardholderPresent` string, nullable: Indicates whether the cardholder was present.
      - `cardPresent` string, nullable: Indicates whether the card was present.
      - `cardInput` string, nullable: Card input.
      - `cardholderAuthenticationMethod1` string, nullable: Card holder authentication method 1.
      - `cardholderAuthenticationMethod2` string, nullable: Card holder authentication method 2.
      - `cardholderAuthenticationMethod3` string, nullable: Card holder authentication method 3.
      - `cardholderAuthenticationMethod4` string, nullable: Card holder authentication method 4.
      - `cardholderAuthenticationEntity1` string, nullable: Card holder authentication entity 1.
      - `cardholderAuthenticationEntity2` string, nullable: Card holder authentication entity 2.
      - `cardholderAuthenticationEntity3` string, nullable: Card holder authentication entity 3.
      - `cardholderAuthenticationEntity4` string, nullable: Card holder authentication entity 4.
      - `chipFallback` string, nullable: Chip fall back.
      - `fraudIndicator` string, nullable: Fraud indicator.
      - `securityCardholderToMerchant` string, nullable: Description of Security Cardholder to Merchant.
      - `secure3DAuthenticationMethod` string, nullable: Secure 3D auth method.
      - `instantFundingNetwork` string, nullable: Instant Funding (Network indicator).
      - `instantFundingThredd` string, nullable: Instant Funding (Thredd indicator).
      - `scaExempt` string, nullable: Exempt From SCA.
      - `scaAssessment` string, nullable: SCA Assessment.
      - `scaKnowledgeTest` string, nullable: SCA Knowledge test.
      - `scaPossessionTest` string, nullable: SCA Possession test.
      - `scaBiometricTest` string, nullable: SCA Biometric test.
      - `threddDetectedSCAExemption` string, nullable: Thredd detected SCA exemption.
      - `cardDeviceFormFactor` string, nullable: Card/Device Form Factor
      - `acquirerExemptSCAIndicator` string, nullable: Acquirer Exempt from SCA Indicator
      - `authenticationAmountAndCurrencyComparisonResult` string, nullable: Result of the Authentication Amount and Currency comparison
      - `merchantCardholderInitiatedIndicator` string, nullable: Merchant or cardholder initiated indicator
      - `merchantInitiatedTransactionTypeIndicator` string, nullable: Merchant Initiated transaction type (or setup of) indicator
      - `originalTransactionSCAExemptIndicator` string, nullable: Original transaction SCA exempt indicator
      - `originalTransactionSCAAssessmentResult` string, nullable: Original transaction SCA assessment result
      - `originalTransactionStatusValue` string, nullable: Original transaction status value
      - `extendedAuthorizationIndicator` string, nullable: Extended Authorization indicator
    - `posCapabilities` PosCapabilities: Capabilities of the Point of Sale equipment.
      - `attended` string, nullable: Attended.
      - `cardCapture` string, nullable: Card Capture.
      - `cardholderAuthentication` string, nullable: Cardholder authentication.
      - `cardInput` string, nullable: Card Input.
      - `cardOutput` string, nullable: Card Output.
      - `environment` string, nullable: Environment.
      - `partialApproval` string, nullable: Partial approval.
      - `pinCapture` string, nullable: PIN capture.
      - `purchaseAmountOnlyApproval` string, nullable: Purchase amount only approval.
      - `terminalOutput` string, nullable: Terminal output.
      - `terminalType` string, nullable: Terminal Type.
    - `preAuthorisationDays` integer, nullable: Pre authorisation days
    - `psdScaExempt` string, nullable: PSD SCA exemption.
    - `rateType` string, nullable: Rate type.
    - `settlementIndicator` string, nullable: Settlement indicator.
  - `paymentTokenId` integer, nullable: ID of the card payment token.
  - `paymentMethod` string, nullable: Card/Wallet/None
  - `ehiMode` integer: EHI mode for the product type.
  - `title` string, nullable: Title
  - `firstname` string, required: First name
  - `lastname` string, required: Last name
  - `panToken` integer, required: Pan token
  - `pubToken` integer, required: public token

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Server Error

## Changes

- **2026-11-03** `a5b5e4fdcf41`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thredd/apis/core-cards/changes/api/v1/program-manager/transactions/get.md)

---

[API](https://skmtc.dev/thredd/apis/core-cards.md) - [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) - [OpenAPI document](https://skmtc.dev/thredd/apis/core-cards/revisions/a5b5e4fdcf41?raw)
