# Get transaction activity for a managed card

Returns all transactional activity on the managed card identified by the id path parameter.

This includes pending authorisations, completed settlements, refunds, and all other card transaction types
in a unified schema.

Endpoint: GET /managed_cards/{id}/transactions
Version: v3
Security: auth_token, api-key

## Path parameters:

  - `id` (string, required)
    The unique identifier of the managed card.

## Query parameters:

  - `offset` (integer)
    The offset value for paging, indicating the initial item number to be returned from the data set satisfying the given criteria. Leave out to fetch the first page of results.

  - `limit` (integer)
    The limit of the results for paging, starting at the offset. Limit is always capped at 100.

  - `type` (array)
    Filter by one or more transaction activity types.
    Enum: "transfers", "sends", "outgoing_wire_transfers", "correspondent_bank_transfers", "incoming_wire_transfers", "card_payments", "fees", "system_transactions"

  - `status` (array)
    Filter by one or more normalised transaction statuses.
    Enum: "DRAFT", "SUBMITTED", "PROCESSING", "COMPLETED", "CANCELLED", "RETURNED"

  - `direction` (string)
    Filter by transaction direction (CREDIT or DEBIT).
    Enum: "CREDIT", "DEBIT"

  - `creationTimestampFrom` (integer)
    Filter for transactions created after this timestamp. Epoch timestamp using millisecond precision.

  - `creationTimestampTo` (integer)
    Filter for transactions created before this timestamp. Epoch timestamp using millisecond precision.

  - `lastUpdatedTimestampFrom` (integer)
    Filter for transactions last updated after this timestamp. Useful for pulling recently changed transactions. Epoch timestamp using millisecond precision.

  - `lastUpdatedTimestampTo` (integer)
    Filter for transactions last updated before this timestamp. Epoch timestamp using millisecond precision.

  - `sortOrder` (string)
    Sort order for the results:
  - ASC: Ascending order, oldest first.
  - DESC: Descending order, most recent first.
    Enum: "ASC", "DESC"

  - `sortBy` (string)
    The field to sort transaction activity results by. Defaults to creationTimestamp.
    Enum: "creationTimestamp", "lastUpdatedTimestamp"

## Response 200 fields (application/json):

  - `transactions` (array)

  - `transactions.id` (string, required)
    The transaction identifier.

  - `transactions.type` (string, required)
    The type of transaction:
  - transfers: Internal transfer between instruments of the same identity
  - sends: Transfer between instruments of different identities
  - outgoing_wire_transfers: Wire transfer to an external bank account
  - correspondent_bank_transfers: Wire transfer on behalf of a third-party originator
  - incoming_wire_transfers: Wire transfer received from an external bank account
  - card_payments: Card payment (purchase, refund, OCT, etc.) with full lifecycle
  - fees: Fee charged or reversed on an instrument
  - system_transactions: System-generated transactions (balance adjustments, account closures, dispute outcomes, etc.)
    Enum: same as `type` (8 values)

  - `transactions.status` (string, required)
    Normalised lifecycle status of a transaction:
  - DRAFT: Transaction ID has been created. There are additional user-actions required before the transaction is considered an “executable instruction” that is fully submitted. No balance movements have taken place on the target instrument yet.
  - SUBMITTED: Transaction has been submitted and is awaiting processing. No balance movements have taken place yet. Transactions scheduled for processing on a future date remain in a submitted status.
  - PROCESSING: The submitted transaction is being processed.
  - COMPLETED: Executed and processed. Funds have moved, actual balance changed.
  - CANCELLED: Transaction was cancelled before completion. Funds have been returned to the original instrument. 
  - RETURNED: The transaction was previously COMPLETED but has been returned. Funds have been returned to the original instrument. Note that card refunds may be separate transactions, not RETURNED purchases.
    Enum: same as `status` (6 values)

  - `transactions.direction` (string)
    Whether funds were credited to or debited from the instrument.
    Enum: same as `direction` (2 values)

  - `transactions.amount` (object, required)
    The primary transaction amount in the instrument's currency.

  - `transactions.amount.currency` (string, required)
    The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

  - `transactions.amount.amount` (integer, required)
    The monetary amount, scaled to the lowest denomination of the currency.

Example, an amount of 1000 for a EUR currency is actually 1000 Euro cents or EUR 10.00.

  - `transactions.fee` (object)
    The fee linked to this transaction, if any.

  - `transactions.fee.id` (string, required)
    Identifier of the fee — same value used as entryId on the corresponding fees-type entry, and as the fee transaction id in the Transaction Activity API.

  - `transactions.fee.type` (string, required)
    Always fees. Aligns with the top-level transaction type.
    Enum: "fees"

  - `transactions.fee.amount` (object, required)
    Fee amount in the instrument's currency.

  - `transactions.fee.subtype` (string)
    Categorises the fee — derived from the parent transaction type.
    Enum: "fee_reversals", "incoming_wire_fees", "withdrawal_fees", "purchase_fees", "refund_fees", "atm_withdrawal_fees", "chargeback_fees", "transfer_fees", "send_fees", "outgoing_wire_transfer_fees", "custom_fees", "other_fees", "instrument_delete_fees", "funds_redemption_fees", "system_transaction_fees"

  - `transactions.creationTimestamp` (integer, required)

  - `transactions.lastUpdatedTimestamp` (integer)

  - `transactions.transaction` (any) — one of:
    The full transaction object. Schema matches the value of type.
    - Transfer:
      - `id` (string, required)
        The unique identifier of a Transfer transaction.
      - `profileId` (string, required)
        The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.
      - `tag` (string)
        The tag field is a custom field that can be used to search and filter.
      - `source` (object, required)
        The source managed account or card from where the funds were transferred.
      - `source.id` (string, required)
      - `source.type` (string, required)
        Enum: "managed_cards", "managed_accounts"
      - `destination` (object, required)
        The destination managed account or card to where the funds were transferred.
      - `destinationAmount` (object, required)
        The amount, in same currency as source and destination, that was transferred from the source to the destination instrument.
      - `description` (string)
        The description details that are included in the transaction as reference.
      - `state` (string, required)
        Status of the transaction.
        Enum: "INITIALISED", "COMPLETED", "REJECTED", "FAILED", "PENDING", "SCHEDULED", "CANCELLED"
      - `creationTimestamp` (integer, required)
        The time when the transaction was created, expressed in Epoch timestamp using millisecond precision.
      - `scheduledTimestamp` (string)
        The epoch timestamp at which the transaction is scheduled to be executed.
      - `executionTimestamp` (string)
        The epoch timestamp at which the transaction was executed, transitioning to a final state such as COMPLETED, REJECTED, or FAILED.
      - `cancellationReason` (string)
        The reason the scheduled transaction was cancelled.
    - Send:
      - `id` (string, required)
        The unique identifier of a send transaction.
      - `profileId` (string, required)
        The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.
      - `tag` (string)
        The tag field is a custom field that can be used to search and filter.
      - `source` (object, required)
        The source managed account or card from where the funds were sent.
      - `source.id` (string, required)
      - `source.type` (string, required)
        Enum: same as `source.type` in "Transfer" (2 values)
      - `sourceFee` (object)
        The object representing a monetary amount in a particular currency.
      - `sourceFee.currency` (string, required)
        The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.
      - `sourceFee.amount` (integer, required)
        The monetary amount, scaled to the lowest denomination of the currency.

Example, an amount of 1000 for a EUR currency is actually 1000 Euro cents or EUR 10.00.
      - `destination` (any)
        The destination managed account or card to where the funds were sent.
        - `beneficiaryId` (string, required)
      - `destinationAmount` (object, required)
        The amount, in same currency as source and destination, that was sent from the source to the destination instrument.
      - `destinationFee` (object)
        The object representing a monetary amount in a particular currency.
      - `destinationFee.currency` (string, required)
        The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.
      - `destinationFee.amount` (integer, required)
        The monetary amount, scaled to the lowest denomination of the currency.

Example, an amount of 1000 for a EUR currency is actually 1000 Euro cents or EUR 10.00.
      - `transactionAmount` (object, required)
        The object representing a monetary amount in a particular currency.
      - `transactionAmount.currency` (string, required)
        The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.
      - `transactionAmount.amount` (integer, required)
        The monetary amount, scaled to the lowest denomination of the currency.

Example, an amount of 1000 for a EUR currency is actually 1000 Euro cents or EUR 10.00.
      - `description` (string)
        The description details that are passed to the beneficiary.
      - `state` (string, required)
        The state of the send transaction, as follows:
 - INVALID: The send transaction has failed initial validation checks. 
 - INITIALISED: The initial state of a send transaction when SCA is not required.
 - PENDING_CHALLENGE: The send transaction requires the completion of a transaction confirmation challenge before it can be submitted.
 - PENDING: The send transaction has exceeded the destination limit and is pending treasury approval.
 - APPROVED: The send transaction that was submitted has been approved.
 - COMPLETED: The requested funds have been sent from the source instrument.
 - REJECTED: The send transaction that was submitted was rejected.
 - FAILED: There was an issue with the send transaction, and the transaction has failed.
 - RETURNED: The send transaction has been returned to the sender.
 - SCHEDULED: The send transaction will be executed at the scheduled time.
 - CANCELLED: The scheduled send transaction has been cancelled.
        Enum: "INVALID", "INITIALISED", "COMPLETED", "REJECTED", "FAILED", "PENDING", "PENDING_CHALLENGE", "APPROVED", "RETURNED", "SCHEDULED", "CANCELLED"
      - `challengeExemptionReason` (string)
        The Reason the transaction was exempted from SCA verification
        Enum: "LOW_VALUE", "TRUSTED_BENEFICIARY"
      - `creationTimestamp` (integer, required)
        The time when the transaction was created, expressed in Epoch timestamp using millisecond precision.
      - `scheduledTimestamp` (string)
        The epoch timestamp at which the transaction is scheduled to be executed.
      - `executionTimestamp` (string)
        The epoch timestamp at which the transaction was executed, transitioning to a final state such as COMPLETED, REJECTED, or FAILED.
      - `cancellationReason` (string)
        The reason the scheduled transaction was cancelled.
    - OutgoingWireTransfer:
      - `id` (string, required)
        The unique identifier of an Outgoing Wire Transfer transaction.
      - `profileId` (string, required)
        The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.
      - `tag` (string)
        The tag field is a custom field that can be used to search and filter.
      - `sourceInstrument` (object, required)
        The source managed account from where the funds were taken.
      - `sourceInstrument.type` (string, required)
        Enum: "managed_accounts"
      - `sourceInstrument.id` (string, required)
      - `transferAmount` (object, required)
        The amount, in same currency as source and destination, that was transferred from the source.
      - `fee` (object)
        The fee charged on this outgoing wire transfer. Omitted when no fee was charged.
      - `purpose` (string)
        The purpose of the payment.
      - `description` (string)
        Transaction description.
      - `type` (string)
        The wire transfer rails used, from SEPA, Faster Payments, SWIFT or RIX.
        Enum: "SEPA", "FASTER_PAYMENTS", "SWIFT", "RIX"
      - `destination` (any) — one of:
        - OutgoingWireTransferBeneficiary:
          - `name` (string, required)
            The beneficiary's full name. The allowed length and pattern is dependent on the bank account details type:

IBANDetails: >= 1 character and = 1 character and ;\{@\r\n]*$
(please note that the ’` symbol is the unicode value U+2019 (right single quotation mark) and not the unicode value U+0027 (apostrophe))
          - `type` (string)
            The type of beneficiary account. Required only when FasterPaymentsBankDetailsOrBACSBankDetails are specified
            Enum: "PERSONAL", "BUSINESS"
          - `address` (string)
            The beneficiary’s address. For SEPA, an extended character set is accepted to cater for all European languages. If SEPA does not support a particular character, it is automatically converted to an acceptable alternative, in line with SEPA scheme guidance.
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `bankAccountDetails` (any, required) — one of:
            Details of the beneficiary bank account, depending on the type of transfer chosen.
            - IBANDetails:
              - `iban` (string, required)
                International Bank Account Number, required for wire transfer over SEPA or RIX
              - `bankIdentifierCode` (string)
                BIC, for wire transfer over SEPA or RIX
            - FasterPaymentsBankDetailsOrBACSBankDetails:
              - `accountNumber` (string, required)
                Account number, required for wire transfer over Faster Payments.
              - `sortCode` (string, required)
                Sort code, required for wire transfer over Faster Payments.
              - `secondaryReference` (string)
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - SEPABeneficiary:
          - `name` (string, required)
            The beneficiary's full name. >= 1 character and <= 150 characters.
An extended character set is accepted to cater for all European languages.
If SEPA does not support a particular character, it is automatically
converted to an acceptable alternative, in line with SEPA scheme guidance.
          - `iban` (string, required)
            International Bank Account Number, required for wire transfer over SEPA.
          - `bankIdentifierCode` (string)
            BIC (Bank Identifier Code) for wire transfer over SEPA.
          - `address` (string)
            The beneficiary's address. An extended character set is accepted to cater
for all European languages. If SEPA does not support a particular character,
it is automatically converted to an acceptable alternative.
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - SWIFTBeneficiary:
          - `name` (string, required)
            The beneficiary's full name.
          - `account` (string, required)
            Can be either an account number or an International Bank Account Number (IBAN).
          - `bankIdentifierCode` (string)
            Required if account is not an IBAN. Bank Identifier Code (BIC).
          - `address` (string, required)
            The beneficiary's address.
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string, required)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - RIXBeneficiary:
          - `name` (string, required)
            The beneficiary's full name. >= 1 character and <= 150 characters.
An extended character set is accepted to cater for all European languages.
If RIX does not support a particular character, it is automatically
converted to an acceptable alternative.
          - `iban` (string, required)
            International Bank Account Number, required for wire transfer over RIX.
          - `bankIdentifierCode` (string)
            BIC (Bank Identifier Code) for wire transfer over RIX.
          - `address` (string)
            The beneficiary's address. An extended character set is accepted to cater
for all European languages. If RIX does not support a particular character,
it is automatically converted to an acceptable alternative.
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - FasterPaymentsBeneficiary:
          - `name` (string, required)
            The beneficiary's full name. >= 1 character and <= 140 characters.
Note: the ' symbol is the unicode value U+2019 (right single quotation mark)
and not the unicode value U+0027 (apostrophe).
          - `type` (string, required)
            The type of beneficiary account. Required for Faster Payments.
            Enum: same as `type` in "OutgoingWireTransferBeneficiary" (2 values)
          - `accountNumber` (string, required)
            Account number, required for wire transfer over Faster Payments.
          - `sortCode` (string, required)
            Sort code, required for wire transfer over Faster Payments.
          - `secondaryReference` (string)
            Optional secondary reference for accounts without unique sort codes.
          - `address` (string)
            The beneficiary's address.
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - BeneficiaryId:
          - `beneficiaryId` (string, required)
        - ExternalAccountId:
          - `type` (string, required)
            Enum: "linked_accounts"
          - `id` (string, required)
      - `state` (string, required)
        The state of the Outgoing wire transfer transaction, as follows:
  - INVALID: The wire transfer has failed initial validation checks.
  - PENDING_CHALLENGE: The wire transfer requires the completion of a transaction confirmation challenge before it can be submitted.
  - SUBMITTED: The wire transfer has been submitted to the sending financial institution for processing.
  - REJECTED: The wire transfer that was submitted was rejected.
  - APPROVED: The wire transfer that was submitted has been approved and is being processed by the sending financial institution.
  - FAILED: There was an issue with the wire transfer, and the transaction has failed.
  - COMPLETED: The requested funds have been sent from the source instrument.
  - RETURNED: The wire transfer has been returned to the sender.
  - SCHEDULED: The wire transfer will be executed at the scheduled time.
  - CANCELLED: The scheduled wire transfer has been cancelled.
  - PENDING_CONFIRMATION: The wire transfer requires a manual confirmation by the user before proceeding.
        Enum: "INVALID", "PENDING_CHALLENGE", "SUBMITTED", "REJECTED", "APPROVED", "FAILED", "COMPLETED", "RETURNED", "SCHEDULED", "CANCELLED", "PENDING_CONFIRMATION"
      - `rejectedInfo` (string)
        Additional info when the outgoing wire transfer has been rejected, as follows:
  - SYSTEM: The wire transfer was rejected by the system.
  - USER: The wire transfer was rejected by the user.
        Enum: "SYSTEM", "USER"
      - `challengeExemptionReason` (string)
        The Reason the transaction was exempted from SCA verification
        Enum: same as `challengeExemptionReason` in "Send" (2 values)
      - `creationTimestamp` (integer, required)
        The time when the transaction was created, expressed in Epoch timestamp using millisecond precision.
      - `scheduledTimestamp` (string)
        The epoch timestamp at which the transaction is scheduled to be executed.
      - `executionTimestamp` (string)
        The epoch timestamp at which the transaction was executed, transitioning to a final state such as COMPLETED, REJECTED, or FAILED.
      - `cancellationReason` (string)
        The reason the scheduled transaction was cancelled.
      - `validationOutcomes` (array)
      - `validationOutcomes.category` (string, required)
        Enum: "UK_CONFIRMATION_OF_PAYEE", "SEPA_VERIFICATION_OF_PAYEE"
      - `validationOutcomes.categoryResult` (any, required) — one of:
        - UKConfirmationOfPayeeResult:
          - `match` (string, required)
            The result of matching performed by the UK Confirmation of Payee responder
            Enum: "EXACT_MATCH", "CLOSE_MATCH", "NO_MATCH", "NOT_POSSIBLE"
          - `reasonCode` (string)
            The reason why the matching failed at the UK Confirmation of Payee responder:

  - ANNM: The CoP responder confirms that the account name provided does not match;
  - MBAM: The CoP responder indicates that the account name provided closely matches the actual account in its records, the actual account name is returned in the accountName field;
  - BANM: The account type that the user specified is 'PERSONAL', but the CoP responder indicates that the actual account matching the name provided is actually BUSINESS;
  - PANM: The account type that the user specified is 'BUSINESS', but the CoP responder indicates that the actual account matching the name provided is actually PERSONAL;
  - BAMM: The account type that the user specified is 'PERSONAL', but the CoP responder indicates that an account closely matching the name provided is BUSINESS;
  - PAMM: The account type that the user specified is 'BUSINESS', but the CoP responder indicates that an account closely matching the name provided is PERSONAL;
  - AC01: The account does not exist in the CoP responders books, the accountNumber specified is likely incorrect; 
  - IVCR: The CoP responder was unable to locate an account based on the secondaryReference field;
  - ACNS: The account is not supported for CoP by the CoP responder;
  - OPTO: The owner of the account has opted out of CoP service by the CoP responder;
  - CASS: The account has been switched using the Current Account Switch Service;
  - SCNS: The sortCode provided is not supported at endpoint;
            Enum: "ANNM", "MBAM", "BANM", "PANM", "BAMM", "PAMM", "AC01", "IVCR", "ACNS", "OPTO", "CASS", "SCNS"
          - `accountName` (string)
            CoP: Returned when the match is a CLOSE_MATCH and the reasonCode is MBAM, BAMM or PAMM
VoP: Returned when the match is a CLOSE_MATCH
        - SEPAVerificationOfPayeeResult:
          - `match` (string, required)
            The result of the SEPA Verification of Payee check performed by the responding PSP.
            Enum: "MATCH", "NO_MATCH", "CLOSE_MATCH", "NOT_POSSIBLE"
          - `accountName` (string)
            The name of the account holder as registered with the responding PSP.
Returned when the match result is CLOSE_MATCH to help the payer verify the payee.
    - CorrespondentBankingOwt:
      - `id` (string, required)
        The unique identifier of the Correspondent Banking OWT.
      - `profileId` (string, required)
        The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.
      - `tag` (string)
        The tag field is a custom field that can be used to search and filter.
      - `sourceInstrument` (object, required)
        The source managed account from where the funds were taken.
      - `sourceInstrument.type` (string, required)
        Enum: same as `sourceInstrument.type` in "OutgoingWireTransfer" (1 values)
      - `sourceInstrument.id` (string, required)
      - `amount` (object, required)
        The amount transferred.
      - `originator` (any, required) — one of:
        - CorrespondentBankingIndividualOriginator:
          - `tag` (string)
            The tag field is a custom field that can be used to search and filter.
          - `name` (string, required)
            Full name of the individual as documented on official ID.
          - `address` (string, required)
            Full residential address of the individual.
          - `country` (string, required)
            ISO 3166-1 alpha-2 country code.
          - `bankAccountDetails` (object, required)
            Account and financial institution details of the originator (travel rule mandatory).
          - `bankAccountDetails.account` (string, required)
            Can be either an account number or an International Bank Account Number (IBAN).
          - `bankAccountDetails.financialInstitution` (string, required)
            Bank Identifier Code (BIC) of the originator's financial institution.
          - `supplementaryInformation` (any) — one of:
            - CorrespondentBankingIndividualAddressAndIdInfo:
              - `documentType` (string, required)
                Type of personal identification document.
                Enum: "NATIONAL_ID", "PASSPORT", "TAX_ID", "OTHER"
              - `documentNumber` (string, required)
                Personal identification document number.
            - CorrespondentBankingIndividualAddressAndBirthInfo:
              - `dateOfBirth` (string, required)
                Date of birth in YYYY-MM-DD format.
              - `placeOfBirth` (string, required)
                Place of birth - city and country.
        - CorrespondentBankingBusinessOriginator:
          - `tag` (string)
            The tag field is a custom field that can be used to search and filter.
          - `name` (string, required)
            Full legal name of the business entity.
          - `registrationAddress` (string, required)
            Registered address of the business entity.
          - `registrationCountry` (string, required)
            ISO 3166-1 alpha-2 country code of registration.
          - `bankAccountDetails` (object, required)
            Account and financial institution details of the originator (travel rule mandatory).
          - `bankAccountDetails.account` (string, required)
            Can be either an account number or an International Bank Account Number (IBAN).
          - `bankAccountDetails.financialInstitution` (string, required)
            Bank Identifier Code (BIC) of the originator's financial institution.
          - `supplementaryInformation` (object)
            Business identification for a business originator.
          - `supplementaryInformation.documentType` (string, required)
            Type of business identification document.
            Enum: "LEI", "REGISTRATION_NUMBER", "TAX_ID", "OTHER"
          - `supplementaryInformation.documentNumber` (string, required)
            Business identification document number (e.g. LEI code, company registration number).
      - `beneficiary` (any, required) — one of:
        - CorrespondentBankingSEPABeneficiary:
          - `name` (string, required)
            The beneficiary's full name. >= 1 character and <= 35 characters.
An extended character set is accepted to cater for all European languages.
If SEPA does not support a particular character, it is automatically
converted to an acceptable alternative, in line with SEPA scheme guidance.
          - `iban` (string, required)
            International Bank Account Number, required for wire transfer over SEPA.
          - `bankIdentifierCode` (string)
            BIC (Bank Identifier Code) for wire transfer over SEPA.
          - `address` (string, required)
            The beneficiary's address. Required for correspondent banking transfers.
Maximum 105 characters (split into 3x35-char lines by the provider).
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - CorrespondentBankingRIXBeneficiary:
          - `name` (string, required)
            The beneficiary's full name. >= 1 character and <= 35 characters.
An extended character set is accepted to cater for all European languages.
If RIX does not support a particular character, it is automatically
converted to an acceptable alternative.
          - `iban` (string, required)
            International Bank Account Number, required for wire transfer over RIX.
          - `bankIdentifierCode` (string)
            BIC (Bank Identifier Code) for wire transfer over RIX.
          - `address` (string, required)
            The beneficiary's address. Required for correspondent banking transfers.
Maximum 105 characters (split into 3x35-char lines by the provider).
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
        - CorrespondentBankingFasterPaymentsBeneficiary:
          - `name` (string, required)
            The beneficiary's full name. >= 1 character and <= 35 characters.
Note: the ' symbol is the unicode value U+2019 (right single quotation mark)
and not the unicode value U+0027 (apostrophe).
          - `type` (string, required)
            The type of beneficiary account. Required for Faster Payments.
            Enum: same as `type` in "OutgoingWireTransferBeneficiary" (2 values)
          - `accountNumber` (string, required)
            Account number, required for wire transfer over Faster Payments.
          - `sortCode` (string, required)
            Sort code, required for wire transfer over Faster Payments.
          - `secondaryReference` (string)
            Optional secondary reference for accounts without unique sort codes.
          - `address` (string, required)
            The beneficiary's address. Required for correspondent banking transfers.
Maximum 105 characters (split into 3x35-char lines by the provider).
          - `bankName` (string)
            The beneficiary's bank name.
          - `bankAddress` (string)
            The beneficiary's bank address.
          - `bankCountry` (string)
            The beneficiary's bank country in ISO 3166 alpha-2 format.
          - `nationality` (string)
            Nationality of the user - using ISO 3166 alpha-2.
          - `dateOfBirth` (string)
            The date of birth in ISO 8601 format (YYYY-MM-DD).
      - `purpose` (string, required)
        The purpose of the payment.
      - `description` (string)
        These details are passed to the beneficiary as the reference. This field is mandatory for wire transfers executed over SEPA. The allowed length is dependent on the payment type:

SEPA <= 35 characters. An extended character set is accepted to cater for all European languages. If SEPA does not support a particular character, it is automatically converted to an acceptable alternative, in line with SEPA scheme guidance.

Faster Payments <= 18 characters
      - `externalData` (array)
        Additional external data as key-value pairs.
      - `externalData.name` (string, required)
        Name/key of the external data.
      - `externalData.value` (string, required)
        Value of the external data.
      - `state` (string, required)
        The state of the correspondent bank transfer transaction, as follows:
  - INVALID: The transfer has failed initial validation checks.
  - PENDING_CHALLENGE: The transfer requires the completion of a transaction confirmation challenge before it can be submitted.
  - SUBMITTED: The transfer has been submitted to the sending financial institution for processing.
  - REJECTED: The transfer that was submitted was rejected.
  - APPROVED: The transfer that was submitted has been approved and is being processed by the sending financial institution.
  - FAILED: There was an issue with the transfer, and the transaction has failed.
  - COMPLETED: The requested funds have been sent from the source instrument.
  - RETURNED: The transfer has been returned to the sender.
  - SCHEDULED: The transfer will be executed at the scheduled time.
  - CANCELLED: The scheduled transfer has been cancelled.
  - PENDING_CONFIRMATION: The transfer requires a manual confirmation by the user before proceeding.
        Enum: same as `state` in "OutgoingWireTransfer" (11 values)
      - `creationTimestamp` (integer, required)
        The time when the transaction was created, expressed in Epoch timestamp using millisecond precision.
      - `scheduledTimestamp` (string)
        The epoch timestamp at which the transaction is scheduled to be executed.
      - `cancellationReason` (string)
        The reason the scheduled transaction was cancelled.
      - `validationOutcomes` (array)
      - `validationOutcomes.category` (string, required)
        Enum: "SEPA_VERIFICATION_OF_PAYEE", "UK_CONFIRMATION_OF_PAYEE"
      - `validationOutcomes.categoryResult` (any, required) — one of:
        - SEPAVerificationOfPayeeResult:
          - `match` (string, required)
            The result of the SEPA Verification of Payee check performed by the responding PSP.
            Enum: same as `match` in "SEPAVerificationOfPayeeResult" (4 values)
          - `accountName` (string)
            The name of the account holder as registered with the responding PSP.
Returned when the match result is CLOSE_MATCH to help the payer verify the payee.
        - UKConfirmationOfPayeeResult:
          - `match` (string, required)
            The result of matching performed by the UK Confirmation of Payee responder
            Enum: same as `match` in "UKConfirmationOfPayeeResult" (4 values)
          - `reasonCode` (string)
            The reason why the matching failed at the UK Confirmation of Payee responder:

  - ANNM: The CoP responder confirms that the account name provided does not match;
  - MBAM: The CoP responder indicates that the account name provided closely matches the actual account in its records, the actual account name is returned in the accountName field;
  - BANM: The account type that the user specified is 'PERSONAL', but the CoP responder indicates that the actual account matching the name provided is actually BUSINESS;
  - PANM: The account type that the user specified is 'BUSINESS', but the CoP responder indicates that the actual account matching the name provided is actually PERSONAL;
  - BAMM: The account type that the user specified is 'PERSONAL', but the CoP responder indicates that an account closely matching the name provided is BUSINESS;
  - PAMM: The account type that the user specified is 'BUSINESS', but the CoP responder indicates that an account closely matching the name provided is PERSONAL;
  - AC01: The account does not exist in the CoP responders books, the accountNumber specified is likely incorrect; 
  - IVCR: The CoP responder was unable to locate an account based on the secondaryReference field;
  - ACNS: The account is not supported for CoP by the CoP responder;
  - OPTO: The owner of the account has opted out of CoP service by the CoP responder;
  - CASS: The account has been switched using the Current Account Switch Service;
  - SCNS: The sortCode provided is not supported at endpoint;
            Enum: same as `reasonCode` in "UKConfirmationOfPayeeResult" (12 values)
          - `accountName` (string)
            CoP: Returned when the match is a CLOSE_MATCH and the reasonCode is MBAM, BAMM or PAMM
VoP: Returned when the match is a CLOSE_MATCH
    - IncomingWireTransfer:
      - `id` (string, required)
        The unique identifier of the incoming wire transfer.
      - `profileId` (string)
        The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.
      - `state` (string, required)
        The state of an incoming wire transfer:
  - PENDING: The transfer has been received and is being processed. Funds have not yet been credited to the destination account.
  - COMPLETED: Funds have been credited to the destination account.
  - REJECTED: The transfer was not accepted; funds were not credited.
        Enum: "PENDING", "COMPLETED", "REJECTED"
      - `amount` (object, required)
        The amount credited (or to be credited) to the destination instrument, in the instrument's currency.
      - `fee` (object)
        The fee charged on this incoming wire transfer. Omitted when no fee was charged.
      - `destinationInstrument` (object, required)
        The managed account (with IBAN) that received the funds.
      - `destinationInstrument.id` (string, required)
      - `destinationInstrument.type` (string, required)
        Enum: same as `source.type` in "Transfer" (2 values)
      - `paymentNetwork` (string)
        The payment network over which the transfer was received.
        Enum: "SEPA", "FASTER_PAYMENTS", "SWIFT", "RIX", "BACS", "CHAPS", "TARGET"
      - `senderName` (string)
        The name of the sender.
      - `senderIban` (string)
        The IBAN of the sender.
      - `senderReference` (string)
        The payment reference provided by the sender.
      - `forex` (object)
        Foreign exchange details when the transaction involved currency conversion.
      - `forex.originalAmount` (object)
        The original amount in the source or merchant currency before conversion.
      - `forex.exchangeRate` (object)
        The exchange rate applied to the conversion.
      - `forex.exchangeRate.value` (integer)
      - `forex.exchangeRate.scale` (integer)
      - `forex.paddingAmount` (object)
        The forex padding amount held during authorisation.
      - `forex.feeAmount` (object)
        The forex markup fee amount.
      - `isInstant` (boolean)
        Whether this was an instant payment.
      - `createdAt` (integer, required)
        When the IWT was received, expressed in Epoch timestamp using millisecond precision.
      - `executedAt` (integer)
        When the IWT was settled, expressed in Epoch timestamp using millisecond precision.
    - CardPayment:
      - `id` (string, required)
        Stable identifier across the entire payment lifecycle.
      - `profileId` (string)
        The profile Id which a specific identity, instrument or transaction type is linked to.

Profiles contain configuration and determine behavioral aspects of the newly created transaction, for example, fees that may apply.

You can have one or more profiles linked to your application, and these can be used to drive different behaviors according to your product's needs.

Profile Ids can be found in the Multi Portal, in the API Credentials page.
      - `type` (string, required)
        The high-level type of card payment. For finer-grained classification (e.g. distinguishing a sale-purchase from a sale with cashback), see the per-event subtype field.
        Enum: "PURCHASE", "REFUND", "ORIGINAL_CREDIT", "ACCOUNT_FUNDING", "CASH_WITHDRAWAL", "BALANCE_INQUIRY"
      - `card` (object, required)
        The managed card used for this payment.
      - `card.id` (string, required)
        The unique identifier of the managed card.
      - `card.type` (string, required)
        Enum: "managed_cards"
      - `card.mode` (string)
        The mode the card was created in.
  - prepaid: The card has its own balance and can have funds transferred to or from it.
  - debit: The card has no balance of its own; it draws on its parent managed account up to a configurable spend limit.
        Enum: "prepaid", "debit"
      - `card.friendlyName` (string)
        The friendly name chosen for the card.
      - `card.nameOnCard` (string)
        The cardholder name printed on the card.
      - `card.cardBrand` (string)
        The scheme of the card. Restricted to schemes supported by card payments.
        Enum: "MASTERCARD", "VISA"
      - `card.cardNumberFirstSix` (string)
        The first six digits of the card number (BIN range).
      - `card.cardNumberLastFour` (string)
        The last four digits of the card number.
      - `card.linkedUserId` (string)
        Identifier of the authorised user the card is assigned to. Populated only when the card has been assigned to a specific user.
      - `card.parentManagedAccountId` (string)
        Identifier of the managed account this card draws funds from. Populated only when mode is debit.
      - `merchant` (object, required)
        Information about a merchant — used wherever a merchant appears in card-payment flows, statement entries, and transaction activity.
      - `merchant.id` (string, required)
        Merchant identifier (MID) — the acquirer-assigned code that identifies the merchant on card-scheme messages (ISO 8583 DE 42 Card Acceptor Identification Code).
      - `merchant.name` (string, required)
        Merchant name (DBA name).
      - `merchant.nameOther` (string)
        Alternative merchant name as supplied by the card network, when present.
      - `merchant.networkId` (string)
        Identifier assigned by the acquirer or scheme to the merchant.
      - `merchant.categoryCode` (string)
        ISO 18245 merchant category code (MCC).
      - `merchant.description` (string)
        Free-text description of the merchant.
      - `merchant.street` (string)
        Street address of the merchant terminal.
      - `merchant.city` (string)
        City of the merchant terminal.
      - `merchant.state` (string)
        Subdivision (state, province, region) of the merchant terminal.
      - `merchant.postalCode` (string)
        Postal code of the merchant terminal.
      - `merchant.country` (string)
        ISO 3166-1 alpha-2 country code of the merchant terminal.
      - `merchant.telephone` (string)
        Merchant telephone.
      - `merchant.url` (string)
        Merchant website.
      - `merchant.contact` (string)
        Merchant contact (name or email of a representative, when present).
      - `merchant.reference` (string)
        Merchant-supplied reference for the transaction (the merchant's own identifier for what they billed).
      - `merchant.logoUrl` (string)
        Merchant logo URL, when available.
      - `displayAmount` (object, required)
        Platform-maintained headline amount of this card payment, in the cardholder's preferred display currency. The canonical "how much is this payment about" figure — show this on receipts, statements, and notifications and you'll always see a meaningful value.

Headline, not net. This reflects the original / intended amount of the payment and stays stable across reversals and cancellations. To compute the actual net (for accounting), walk events[] and sum the scheme amounts yourself.

Magnitude is always positive. The debit/credit direction is implicit from type (purchases debit, refunds and OCTs credit). For the lifecycle phase, read status. For amounts in the merchant's currency or the card's currency, walk events[].
      - `status` (string, required)
        Lifecycle status of a CardPayment.

- PENDING — authorised, not yet (or not fully) settled. The hold is still on the card.
- SETTLED — fully settled. The customer has been charged.
- DECLINED — the latest authorisation was declined; no money moved.
- CANCELLED — the authorisation was cancelled/reversed before settlement; no charge applied.
- EXPIRED — the authorisation timed out without settling.
        Enum: "PENDING", "SETTLED", "DECLINED", "CANCELLED", "EXPIRED"
      - `relatedCardPaymentId` (string)
        Direct parent linkage — id of the single prior card payment that this payment derives from. Set on:
  - REFUND payments referring to the original purchase
  - ORIGINAL_CREDIT payments referring to the prior purchase being credited
  - Tip / add-on payments referring to the original ride / fare / service
  - Installment / recurring payments referring to the initial setup transaction

Corresponds to Visa's "Original Transaction ID" linkage and Mastercard's DE 105 subelement 002 (Economically Related Transaction Identifier). Not used for messages that share a single lifecycle — those are events on the same card payment.
      - `events` (array, required) — one of (discriminator: type):
        Ordered event stream — every scheme message in this card payment's lifecycle. For headline display use displayAmount; walk this when you need scheme-level detail (per-event amounts, fees, reason codes, reversals).
        - AUTHORISATION:
          - `id` (string, required)
          - `subtype` (string, required)
            Card-scheme network classification of the underlying transaction. Reversal-vs-original lives on the separate reversal field.
            Enum: "sale_purchases", "cash_withdrawals", "sales_with_cashback", "mail_or_telephone_orders", "account_funding"
          - `reversal` (boolean)
            True when this event is a reversal of a prior authorisation in the same lifecycle (e.g. merchant void, expiry, explicit cancellation). False for originals.
          - `result` (string)
            Approved or declined by the issuer. Populated on originals; omitted on reversals.
            Enum: "APPROVED", "DECLINED"
          - `authorisationCategory` (string)
            Pre-auth (provisional hold) or final auth. Populated on originals.
            Enum: "PRE_AUTH", "FINAL_AUTH"
          - `authForwardingDetails` (object)
            When the card is configured for auth forwarding, the forwarding context for this event.
          - `authForwardingDetails.triggered` (boolean)
            True if auth forwarding was triggered for this authorisation.
          - `authForwardingDetails.decisionOutcome` (string)
            Default decision applied if the innovator did not respond in time.
            Enum: "APPROVE", "DECLINE"
          - `authForwardingDetails.innovatorTimedOut` (boolean)
            True if the innovator failed to respond within the configured timeout and the default decision was applied.
          - `declineReason` (string)
            Present when result is DECLINED.
            Enum: "NO_REASON", "PHYSICAL_NOT_ACTIVATED", "INSUFFICIENT_BALANCE", "CVV_CHECKS_FAILED", "CVV_RETRIES_EXCEEDED", "CARD_STATUS_NOT_ALLOWED", "PIN_CHECKS_FAILED", "PIN_RETRIES_EXCEEDED", "CARD_EXPIRY_CHECKS_FAILED", "AVS_CHECKS_FAILED", "ATM_WITHDRAWAL_LIMIT_EXCEEDED", "SCA_REQUIRED", "AUTH_RULE_CHECKS_FAILED", "TRANSACTION_NOT_PERMITTED", "TIMEOUT", "SINGLE_SPEND"
          - `authRuleFailedReason` (string)
            The specific auth rule that caused the decline. Present when declineReason is AUTH_RULE_CHECKS_FAILED. Mirrors the legacy authorisation webhook's authRuleFailedReason.
          - `cancellationReason` (string)
            Free-text reason for an explicit cancellation of an authorisation hold. Populated on reversal: true events driven by explicit cancellation rather than network reversal.
          - `transactionAmount` (object)
            The amount for this event, in the merchant's currency (ISO 8583 DE 4).
          - `billingAmount` (object)
            The amount applied to the card, in the card's currency (ISO 8583 DE 6).
          - `forex` (object)
            Auth-time FX context — exchangeRate and padding. Populated on cross-currency authorisations.
          - `forex.exchangeRate` (object)
            Rate applied to convert transactionAmount into billingAmount at authorisation time. Populated on cross-currency authorisations.
          - `forex.exchangeRate.value` (integer)
          - `forex.exchangeRate.scale` (integer)
          - `forex.padding` (object)
            Extra amount blocked at authorisation time to cater for currency fluctuation between auth and settlement. Already included in the event's transactionAmount; surfaced separately so the embedder can show the cardholder how much of the charge is the FX cushion. Released or absorbed at clearing time.
          - `userAmount` (object)
            Presentation-only amount to be shown to the cardholder in their app. The userAmount will only differ from the billingAmount if a userCurrency was set for the card during card creation.
          - `userExchangeRate` (object)
            Rate applied to convert transactionAmount into userAmount. Presentation-only.
          - `authCode` (string)
            Issuer authorisation code on this scheme message (ISO 8583 DE 38). Echoed by subsequent settlement, refund, OCT messages in the same lifecycle.
          - `fees` (array) — one of (discriminator: type):
            Fees applied as part of this specific event (e.g. interchange on a settlement, forex markup on an authorisation, chargeback fee on a dispute step).
            - PLATFORM_FEE:
              - `id` (string, required)
                Identifier of the underlying FeeTransaction.
              - `subtype` (string, required)
                Category of fee.
                Enum: "purchase_fees", "refund_fees", "atm_withdrawal_fees", "withdrawal_fees", "chargeback_fees", "fee_reversals", "custom_fees", "other_fees"
              - `amount` (object, required)
                Fee amount, in the currency of the instrument the fee was applied to.
            - FOREX_FEE:
              - `amount` (object)
                The forex fee charged on this event, in the currency of the instrument the fee was applied to.
          - `fees.type` (string, required)
            Enum: "PLATFORM_FEE", "FOREX_FEE"
          - `timestamp` (integer, required)
            When this event occurred at the point-of-interaction, Epoch millis.
          - `processedTimestamp` (integer)
            When this event was processed by the platform, Epoch millis.
        - SETTLEMENT:
          - `id` (string, required)
          - `subtype` (string, required)
            Card-scheme network classification of the underlying transaction being settled.
            Enum: same as `subtype` in "AUTHORISATION" (5 values)
          - `reversal` (boolean)
            True when this event reverses a prior settlement; funds return to the card. False for originals.
          - `settlementState` (string, required)
            Processing state of this settlement on the platform.
            Enum: "PENDING", "COMPLETED"
          - `transactionAmount` (object)
            The amount cleared, in the merchant's currency (ISO 8583 DE 4).
          - `billingAmount` (object)
            The amount billed against the card, in the card's currency (ISO 8583 DE 6). May differ from any earlier authorisation due to final amount and forex movement.
          - `exchangeRate` (object)
            Forex rate applied at clearing time.
          - `exchangeRate.value` (integer)
          - `exchangeRate.scale` (integer)
          - `userAmount` (object)
            Presentation-only amount to be shown to the cardholder in their app. The userAmount will only differ from the billingAmount if a userCurrency was set for the card during card creation.
          - `userExchangeRate` (object)
            Rate applied to convert transactionAmount into userAmount. Presentation-only.
          - `authCode` (string)
            Issuer authorisation code (ISO 8583 DE 38) echoed from the originating authorisation.
          - `fees` (array) — one of (discriminator: type):
            Fees applied as part of this specific event (e.g. interchange on a settlement, forex markup on an authorisation, chargeback fee on a dispute step).
            - PLATFORM_FEE:
              - `id` (string, required)
                Identifier of the underlying FeeTransaction.
              - `subtype` (string, required)
                Category of fee.
                Enum: same as `subtype` in "PLATFORM_FEE" (8 values)
              - `amount` (object, required)
                Fee amount, in the currency of the instrument the fee was applied to.
            - FOREX_FEE:
              - `amount` (object)
                The forex fee charged on this event, in the currency of the instrument the fee was applied to.
          - `fees.type` (string, required)
            Enum: same as `fees.type` in "AUTHORISATION" (2 values)
          - `timestamp` (integer, required)
            When this settlement event occurred, Epoch millis.
          - `processedTimestamp` (integer)
            When this event was processed by the platform, Epoch millis.
        - REFUND:
          - `id` (string, required)
          - `reversal` (boolean)
            True when this event reverses a prior refund (money was returned to the cardholder and is now being clawed back). False for an original refund credit.
          - `subtype` (string)
            Card-scheme network classification of the refund. Reversal-vs-original lives on the separate reversal field.
            Enum: "purchase_refunds", "purchase_refund_reversals"
          - `reasonCode` (string)
            Network reason code accompanying the event, when provided by the scheme.
          - `transactionAmount` (object)
            The amount credited / reversed, in the merchant's currency.
          - `billingAmount` (object)
            The amount applied to the card, in the card's currency.
          - `exchangeRate` (object)
            Forex rate applied to convert transactionAmount into billingAmount.
          - `exchangeRate.value` (integer)
          - `exchangeRate.scale` (integer)
          - `userAmount` (object)
            Presentation-only amount to be shown to the cardholder in their app. The userAmount will only differ from the billingAmount if a userCurrency was set for the card during card creation.
          - `userExchangeRate` (object)
            Rate applied to convert transactionAmount into userAmount. Presentation-only.
          - `authCode` (string)
            Issuer authorisation code (ISO 8583 DE 38) echoed from the originating authorisation.
          - `fees` (array) — one of (discriminator: type):
            Fees applied as part of this specific event (e.g. interchange on a settlement, forex markup on an authorisation, chargeback fee on a dispute step).
            - PLATFORM_FEE:
              - `id` (string, required)
                Identifier of the underlying FeeTransaction.
              - `subtype` (string, required)
                Category of fee.
                Enum: same as `subtype` in "PLATFORM_FEE" (8 values)
              - `amount` (object, required)
                Fee amount, in the currency of the instrument the fee was applied to.
            - FOREX_FEE:
              - `amount` (object)
                The forex fee charged on this event, in the currency of the instrument the fee was applied to.
          - `fees.type` (string, required)
            Enum: same as `fees.type` in "AUTHORISATION" (2 values)
          - `timestamp` (integer, required)
            When this event occurred, Epoch millis.
          - `processedTimestamp` (integer)
            When this event was processed by the platform, Epoch millis.
        - ORIGINAL_CREDIT:
          - `id` (string, required)
          - `reversal` (boolean)
            True when this event reverses a prior OCT (push credit being clawed back). False for an original push credit.
          - `subtype` (string)
            Card-scheme network classification of the OCT. Reversal-vs-original lives on the separate reversal field.
            Enum: "original_credit_transactions", "original_credit_transaction_reversals"
          - `reasonCode` (string)
            Network reason code accompanying the event, when provided by the scheme.
          - `transactionAmount` (object)
            The amount credited / reversed, in the merchant's currency.
          - `billingAmount` (object)
            The amount applied to the card, in the card's currency.
          - `exchangeRate` (object)
            Forex rate applied to convert transactionAmount into billingAmount.
          - `exchangeRate.value` (integer)
          - `exchangeRate.scale` (integer)
          - `userAmount` (object)
            Presentation-only amount to be shown to the cardholder in their app. The userAmount will only differ from the billingAmount if a userCurrency was set for the card during card creation.
          - `userExchangeRate` (object)
            Rate applied to convert transactionAmount into userAmount. Presentation-only.
          - `authCode` (string)
            Issuer authorisation code (ISO 8583 DE 38) echoed from the originating authorisation.
          - `fees` (array) — one of (discriminator: type):
            Fees applied as part of this specific event (e.g. interchange on a settlement, forex markup on an authorisation, chargeback fee on a dispute step).
            - PLATFORM_FEE:
              - `id` (string, required)
                Identifier of the underlying FeeTransaction.
              - `subtype` (string, required)
                Category of fee.
                Enum: same as `subtype` in "PLATFORM_FEE" (8 values)
              - `amount` (object, required)
                Fee amount, in the currency of the instrument the fee was applied to.
            - FOREX_FEE:
              - `amount` (object)
                The forex fee charged on this event, in the currency of the instrument the fee was applied to.
          - `fees.type` (string, required)
            Enum: same as `fees.type` in "AUTHORISATION" (2 values)
          - `timestamp` (integer, required)
            When this event occurred, Epoch millis.
          - `processedTimestamp` (integer)
            When this event was processed by the platform, Epoch millis.
      - `events.type` (string, required)
        Type of event recorded against a CardPayment. The reversal flag on each event distinguishes a reversal from the original action.
        Enum: "AUTHORISATION", "SETTLEMENT", "REFUND", "ORIGINAL_CREDIT"
      - `creationTimestamp` (integer, required)
        When the first event for this payment was received, Epoch millis.
      - `lastUpdatedTimestamp` (integer)
        When the most recent event for this payment was received, Epoch millis.
    - FeeTransaction:
      - `id` (string, required)
        The unique identifier of the fee transaction.
      - `feeType` (string, required)
        The category of fee — indicates the activity or instrument-lifecycle event the fee relates to.
        Enum: same as `transactions.fee.subtype` (15 values)
      - `amount` (object, required)
        The fee amount in the instrument's currency.
      - `instrument` (object, required)
        The instrument the fee was charged against.
      - `instrument.id` (string, required)
      - `instrument.type` (string, required)
        Enum: same as `source.type` in "Transfer" (2 values)
      - `status` (string, required)
        Lifecycle status of a fee transaction:
  - PENDING: Fee accompanies a transaction that is still processing; it may still be cancelled.
  - COMPLETED: Fee was charged and posted to the instrument balance.
  - CANCELLED: Fee was cancelled before being charged.
  - REVERSED: Fee was previously charged and has been reversed.
        Enum: "PENDING", "COMPLETED", "CANCELLED", "REVERSED"
      - `description` (string)
      - `relatedTransactionId` (string)
        The parent transaction this fee relates to, if any.
      - `creationTimestamp` (integer, required)
      - `lastUpdatedTimestamp` (integer)
    - SystemTransaction:
      - `id` (string, required)
        The unique identifier of the system transaction.
      - `subtype` (string)
        The specific kind of system-generated transaction.
        Enum: "account_closures", "chargebacks_represented", "chargebacks_won", "manual_auth_expiries", "negative_card_balances", "balance_adjustments", "lost_stolen_replacement_balance_transfers"
      - `amount` (object, required)
        The transaction amount in the instrument's currency.
      - `instrument` (object, required)
        The instrument the transaction was applied to.
      - `instrument.id` (string, required)
      - `instrument.type` (string, required)
        Enum: same as `source.type` in "Transfer" (2 values)
      - `status` (string, required)
        Normalised lifecycle status of a transaction:
  - DRAFT: Transaction ID has been created. There are additional user-actions required before the transaction is considered an “executable instruction” that is fully submitted. No balance movements have taken place on the target instrument yet.
  - SUBMITTED: Transaction has been submitted and is awaiting processing. No balance movements have taken place yet. Transactions scheduled for processing on a future date remain in a submitted status.
  - PROCESSING: The submitted transaction is being processed.
  - COMPLETED: Executed and processed. Funds have moved, actual balance changed.
  - CANCELLED: Transaction was cancelled before completion. Funds have been returned to the original instrument. 
  - RETURNED: The transaction was previously COMPLETED but has been returned. Funds have been returned to the original instrument. Note that card refunds may be separate transactions, not RETURNED purchases.
        Enum: same as `status` (6 values)
      - `reason` (string)
        Operational reason or context for the system transaction.
      - `relatedTransactionId` (string)
        A related transaction this system event corrects or compensates, if any.
      - `creationTimestamp` (integer, required)
      - `lastUpdatedTimestamp` (integer)

  - `count` (integer)
    The total number of records matching the filter criteria.

  - `responseCount` (integer)

## Response 400 fields (application/json):

  - `message` (string)
    When present helps to identify and fix the problem.

  - `syntaxErrors` (object)
    Is returned as part of an HTTP error response whenever a syntax error is detected. A list of the fields together with their syntax error will be provided.

  - `syntaxErrors.invalidFields` (array)

  - `syntaxErrors.invalidFields.params` (array)

  - `syntaxErrors.invalidFields.fieldName` (string)

  - `syntaxErrors.invalidFields.error` (string)
    Enum: "REQUIRED", "HAS_TEXT", "REQUIRES", "SIZE", "RANGE", "IN", "NOT_IN", "REGEX", "EXACTLY", "AT_LEAST", "AT_MOST", "ALL_OR_NONE"

## Response 403 fields (application/json):

  - `errorCode` (string)
    Enum: "STEP_UP_REQUIRED", "ACCESS_TOKEN_REQUIRED", "INSUFFICIENT_PERMISSIONS"

## Response 404 fields (application/json):

  - `code` (string)

  - `message` (string)


## Response 401 fields

## Response 429 fields

## Response 500 fields

## Response 503 fields