> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reap.global/llms.txt
> Use this file to discover all available pages before exploring further.

# List activities

> Retrieves a paginated, chronologically ordered list of fund movements. Supports filtering by resource identifiers, activity type, time window, and status.



## OpenAPI

````yaml /api-reference/openapi.json get /activities/
openapi: 3.1.0
info:
  title: Reap API
  version: 1.0.0
  description: Reap platform API
servers:
  - url: https://sandbox.api.reap.global
    description: Sandbox
  - url: https://prod.api.reap.global
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Activities
  - name: Card Designs
  - name: Card Shipments
  - name: Card Transactions
  - name: Cards
  - name: Companies
  - name: Crypto Deposits
  - name: Policies
  - name: Simulation
  - name: Users
  - name: Virtual Asset Postings
  - name: Virtual Assets
  - name: Webhooks
paths:
  /activities/:
    get:
      tags:
        - Activities
      summary: List activities
      description: >-
        Retrieves a paginated, chronologically ordered list of fund movements.
        Supports filtering by resource identifiers, activity type, time window,
        and status.
      operationId: list_activities
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            default: 20
            examples:
              - 20
              - 50
              - 100
            description: 'Maximum number of items to return (1-100, default: 20)'
            type: integer
            exclusiveMinimum: 0
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            description: >-
              Opaque cursor for pagination. Pass nextCursor from previous
              response to get next page.
            type: string
        - name: accountId
          in: query
          required: false
          schema:
            description: Filter activities by account ID(s) (comma-separated)
            type: array
            items:
              type: string
              format: uuid
        - name: cardId
          in: query
          required: false
          schema:
            description: >-
              Filter activities by card ID(s) (comma-separated, card
              transactions only)
            type: array
            items:
              type: string
              format: uuid
        - name: type
          in: query
          required: false
          schema:
            description: Filter by activity type
            type: string
            enum:
              - CRYPTO_DEPOSIT
              - CARD_TRANSACTION
              - POSTING
            example: CRYPTO_DEPOSIT
        - name: cryptoDepositStatus
          in: query
          required: false
          schema:
            description: Filter crypto deposits by status (comma-separated)
            type: array
            items:
              type: string
              enum:
                - PENDING
                - CONFIRMED
                - APPROVED
                - REJECTED
              description: >-
                - `PENDING`: Transaction detected, awaiting confirmation

                - `CONFIRMED`: Transaction confirmed on-chain, validation in
                progress

                - `APPROVED`: Deposit approved and credited to balance

                - `REJECTED`: Deposit rejected (see rejectionReason)
              example: PENDING
        - name: cardTransactionStatus
          in: query
          required: false
          schema:
            description: Filter card transactions by status (comma-separated)
            type: array
            items:
              type: string
              enum:
                - PENDING
                - CLEARED
                - DECLINED
                - VOID
              description: >-
                - `PENDING`: Authorization approved, awaiting clearing

                - `CLEARED`: Transaction settled

                - `DECLINED`: Authorization was declined

                - `VOID`: Full reversal of pending auth or zero-amount
                verification
              example: PENDING
        - name: virtualAssetId
          in: query
          required: false
          schema:
            description: >-
              Filter postings by virtual asset ID(s) (comma-separated). Matches
              postings that contain at least one entry against any of the given
              virtual assets. Implies `type=POSTING` — non-posting activities
              are never returned when this filter is set.
            type: array
            items:
              type: string
              format: uuid
        - name: since
          in: query
          required: false
          schema:
            description: >-
              Inclusive lower bound on activity time (`occurredAt`). ISO 8601
              datetime.
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        - name: Reap-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-02-14'
            description: API version (YYYY-MM-DD)
            example: '2025-02-14'
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Activity'
                  nextCursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Cursor for next page, or null if no more items
                required:
                  - items
                  - nextCursor
components:
  schemas:
    Activity:
      oneOf:
        - $ref: '#/components/schemas/CryptoDepositActivity'
          title: CryptoDeposit
        - $ref: '#/components/schemas/CardTransactionActivity'
          title: CardTransaction
        - $ref: '#/components/schemas/PostingActivity'
          title: Posting
      description: Activity resource
    CryptoDepositActivity:
      type: object
      properties:
        type:
          type: string
          const: CRYPTO_DEPOSIT
        id:
          type: string
          format: uuid
          description: Activity resource identifier
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp used for chronological ordering
        data:
          $ref: '#/components/schemas/CryptoDeposit'
      required:
        - type
        - id
        - occurredAt
        - data
      description: Crypto deposit activity
    CardTransactionActivity:
      type: object
      properties:
        type:
          type: string
          const: CARD_TRANSACTION
        id:
          type: string
          format: uuid
          description: Activity resource identifier
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp used for chronological ordering
        data:
          $ref: '#/components/schemas/CardTransaction'
      required:
        - type
        - id
        - occurredAt
        - data
      description: Card transaction activity
    PostingActivity:
      type: object
      properties:
        type:
          type: string
          const: POSTING
        id:
          type: string
          format: uuid
          description: Activity resource identifier
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp used for chronological ordering
        data:
          $ref: '#/components/schemas/Posting'
      required:
        - type
        - id
        - occurredAt
        - data
      description: >-
        Partner-driven posting against an account (DEPOSIT, WITHDRAWAL, or
        SETTLEMENT). Prefund programs only.
    CryptoDeposit:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique deposit identifier
        accountId:
          type: string
          format: uuid
          description: Account that received the deposit
        chainId:
          type: string
          enum:
            - ETHEREUM_MAINNET
            - ETHEREUM_SEPOLIA
            - BASE_MAINNET
            - BASE_SEPOLIA
            - ARBITRUM_ONE_MAINNET
            - ARBITRUM_ONE_SEPOLIA
            - POLYGON_MAINNET
            - POLYGON_AMOY
            - SOLANA_MAINNET
            - SOLANA_DEVNET
          description: Blockchain network identifier
          example: ETHEREUM_MAINNET
        transactionId:
          type: string
          examples:
            - '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
          description: On-chain transaction hash/signature
        status:
          type: string
          enum:
            - PENDING
            - CONFIRMED
            - APPROVED
            - REJECTED
          description: Current deposit status
          example: PENDING
        rejectionReason:
          anyOf:
            - type: string
              enum:
                - TRANSACTION_FAILED
                - ASSET_NOT_ACCEPTED
                - KYT_CHECK_FAILED
                - AMOUNT_TOO_SMALL
              description: |-
                - `TRANSACTION_FAILED`: On-chain transaction failed or reverted
                - `ASSET_NOT_ACCEPTED`: Asset is not accepted as collateral
                - `KYT_CHECK_FAILED`: Transaction flagged by compliance checks
                - `AMOUNT_TOO_SMALL`: Amount below minimum threshold (internal)
              example: TRANSACTION_FAILED
            - type: 'null'
          description: Reason for rejection (only when status is `REJECTED`)
        amount:
          type: string
          examples:
            - '1000.0'
            - '0.999999999999999999'
          description: Amount with decimals applied (string for full precision)
        senderAddress:
          type: string
          examples:
            - '0x742d35Cc6634C0532925a3b844Bc9e7595f8fA21'
          description: Address that sent the deposit
        occurredAt:
          anyOf:
            - type: string
            - type: 'null'
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of on-chain transfer
        createdAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          examples:
            - '2024-01-15T10:35:00Z'
          description: ISO 8601 timestamp of last update
        asset:
          $ref: '#/components/schemas/AssetInfo'
      required:
        - id
        - accountId
        - chainId
        - transactionId
        - status
        - rejectionReason
        - amount
        - senderAddress
        - occurredAt
        - createdAt
        - updatedAt
        - asset
    CardTransaction:
      oneOf:
        - $ref: '#/components/schemas/PendingCardTransaction'
          title: Pending
        - $ref: '#/components/schemas/ClearedCardTransaction'
          title: Cleared
        - $ref: '#/components/schemas/DeclinedCardTransaction'
          title: Declined
        - $ref: '#/components/schemas/VoidCardTransaction'
          title: Void
      description: >-
        Card transaction resource. The response shape varies by transaction
        status.
    Posting:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Posting ID
        accountId:
          type: string
          format: uuid
          description: Account ID
        type:
          type: string
          enum:
            - DEPOSIT
            - WITHDRAWAL
            - SETTLEMENT
          description: >-
            - `DEPOSIT`: Credit the submitted virtual asset amounts to the
            account balance.

            - `WITHDRAWAL`: Debit the submitted virtual asset amounts from the
            account balance. Rejected if any entry would take the balance below
            zero.

            - `SETTLEMENT`: Debit the submitted virtual asset amounts from the
            account balance AND apply their value to the account’s outstanding
            card debt. Same non-negative guard as `WITHDRAWAL`.
          example: DEPOSIT
        entries:
          type: array
          items:
            $ref: '#/components/schemas/PostingEntry'
        settledAmount:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            Value applied to outstanding card debt, in the billing currency of
            the card program. Populated for `SETTLEMENT` postings, `null`
            otherwise.
        createdAt:
          type: string
          description: ISO 8601 creation timestamp
      required:
        - id
        - accountId
        - type
        - entries
        - settledAmount
        - createdAt
      description: Client-driven posting against an account.
    AssetInfo:
      type: object
      properties:
        symbol:
          type: string
          examples:
            - USDC
            - USDT
            - ETH
          description: Asset symbol
        name:
          anyOf:
            - type: string
            - type: 'null'
          examples:
            - USD Coin
            - Ethereum
          description: Full asset name
        decimals:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          examples:
            - 6
            - 18
          description: Number of decimal places
        logoUri:
          anyOf:
            - type: string
            - type: 'null'
          description: URI to asset logo image
      required:
        - symbol
        - name
        - decimals
        - logoUri
      description: Asset metadata
    PendingCardTransaction:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Card transaction identifier
        accountId:
          type: string
          format: uuid
          description: Account linked to the card
        cardId:
          type: string
          format: uuid
          description: Card used for this transaction
        channel:
          type: string
          enum:
            - ATM
            - POS
            - ECOMMERCE
            - VISA_DIRECT
          description: Transaction channel
          example: ATM
        digitalWallet:
          anyOf:
            - type: string
              enum:
                - APPLE_PAY
                - GOOGLE_PAY
                - MERCHANT_TOKEN
              example: APPLE_PAY
            - type: 'null'
          description: Digital wallet used, or null if physical card
        originalCurrency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Original transaction currency (merchant local currency)
        currency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Card currency
        merchant:
          $ref: '#/components/schemas/CardTransactionMerchant'
        events:
          type: array
          items:
            $ref: '#/components/schemas/TransactionEvent'
          description: >-
            Chronologically sorted lifecycle events (oldest first). Provides the
            full audit trail of what happened to this transaction.
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of when the transaction was initiated
        createdAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          examples:
            - '2024-01-15T10:35:00Z'
          description: ISO 8601 timestamp of last update
        status:
          type: string
          const: PENDING
        originalAmount:
          $ref: '#/components/schemas/AmountBreakdown'
          description: Amount in the original transaction currency
        amount:
          $ref: '#/components/schemas/AmountBreakdown'
          description: Amount charged to the cardholder
        conversionRate:
          type: number
          minimum: 0
          examples:
            - 1
            - 0.128205
            - 7.812
          description: Conversion rate from the original currency to the card currency
      required:
        - id
        - accountId
        - cardId
        - channel
        - digitalWallet
        - originalCurrency
        - currency
        - merchant
        - events
        - occurredAt
        - createdAt
        - updatedAt
        - status
        - originalAmount
        - amount
        - conversionRate
      description: Authorized transaction that hasn't settled yet
    ClearedCardTransaction:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Card transaction identifier
        accountId:
          type: string
          format: uuid
          description: Account linked to the card
        cardId:
          type: string
          format: uuid
          description: Card used for this transaction
        channel:
          type: string
          enum:
            - ATM
            - POS
            - ECOMMERCE
            - VISA_DIRECT
          description: Transaction channel
          example: ATM
        digitalWallet:
          anyOf:
            - type: string
              enum:
                - APPLE_PAY
                - GOOGLE_PAY
                - MERCHANT_TOKEN
              example: APPLE_PAY
            - type: 'null'
          description: Digital wallet used, or null if physical card
        originalCurrency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Original transaction currency (merchant local currency)
        currency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Card currency
        merchant:
          $ref: '#/components/schemas/CardTransactionMerchant'
        events:
          type: array
          items:
            $ref: '#/components/schemas/TransactionEvent'
          description: >-
            Chronologically sorted lifecycle events (oldest first). Provides the
            full audit trail of what happened to this transaction.
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of when the transaction was initiated
        createdAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          examples:
            - '2024-01-15T10:35:00Z'
          description: ISO 8601 timestamp of last update
        status:
          type: string
          const: CLEARED
        originalAmount:
          $ref: '#/components/schemas/ClearedAmountBreakdown'
          description: Amount in the original transaction currency
        amount:
          $ref: '#/components/schemas/ClearedAmountBreakdown'
          description: Amount charged to the cardholder
        conversionRate:
          type: number
          minimum: 0
          examples:
            - 1
            - 0.128205
            - 7.812
          description: Conversion rate from the original currency to the card currency
      required:
        - id
        - accountId
        - cardId
        - channel
        - digitalWallet
        - originalCurrency
        - currency
        - merchant
        - events
        - occurredAt
        - createdAt
        - updatedAt
        - status
        - originalAmount
        - amount
        - conversionRate
      description: Fully settled transaction
    DeclinedCardTransaction:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Card transaction identifier
        accountId:
          type: string
          format: uuid
          description: Account linked to the card
        cardId:
          type: string
          format: uuid
          description: Card used for this transaction
        channel:
          type: string
          enum:
            - ATM
            - POS
            - ECOMMERCE
            - VISA_DIRECT
          description: Transaction channel
          example: ATM
        digitalWallet:
          anyOf:
            - type: string
              enum:
                - APPLE_PAY
                - GOOGLE_PAY
                - MERCHANT_TOKEN
              example: APPLE_PAY
            - type: 'null'
          description: Digital wallet used, or null if physical card
        originalCurrency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Original transaction currency (merchant local currency)
        currency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Card currency
        merchant:
          $ref: '#/components/schemas/CardTransactionMerchant'
        events:
          type: array
          items:
            $ref: '#/components/schemas/TransactionEvent'
          description: >-
            Chronologically sorted lifecycle events (oldest first). Provides the
            full audit trail of what happened to this transaction.
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of when the transaction was initiated
        createdAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          examples:
            - '2024-01-15T10:35:00Z'
          description: ISO 8601 timestamp of last update
        status:
          type: string
          const: DECLINED
        originalAmount:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Attempted transaction amount in the original currency
        declineReason:
          $ref: '#/components/schemas/DeclineReason'
        policy:
          anyOf:
            - $ref: '#/components/schemas/DeclinedPolicy'
              title: DeclinedPolicy
            - type: 'null'
          description: >-
            The policy that caused the decline, or null if the transaction was
            declined for another reason (e.g. insufficient funds).
      required:
        - id
        - accountId
        - cardId
        - channel
        - digitalWallet
        - originalCurrency
        - currency
        - merchant
        - events
        - occurredAt
        - createdAt
        - updatedAt
        - status
        - originalAmount
        - declineReason
        - policy
      description: Transaction that was declined during authorization
    VoidCardTransaction:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Card transaction identifier
        accountId:
          type: string
          format: uuid
          description: Account linked to the card
        cardId:
          type: string
          format: uuid
          description: Card used for this transaction
        channel:
          type: string
          enum:
            - ATM
            - POS
            - ECOMMERCE
            - VISA_DIRECT
          description: Transaction channel
          example: ATM
        digitalWallet:
          anyOf:
            - type: string
              enum:
                - APPLE_PAY
                - GOOGLE_PAY
                - MERCHANT_TOKEN
              example: APPLE_PAY
            - type: 'null'
          description: Digital wallet used, or null if physical card
        originalCurrency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Original transaction currency (merchant local currency)
        currency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: Card currency
        merchant:
          $ref: '#/components/schemas/CardTransactionMerchant'
        events:
          type: array
          items:
            $ref: '#/components/schemas/TransactionEvent'
          description: >-
            Chronologically sorted lifecycle events (oldest first). Provides the
            full audit trail of what happened to this transaction.
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of when the transaction was initiated
        createdAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          examples:
            - '2024-01-15T10:35:00Z'
          description: ISO 8601 timestamp of last update
        status:
          type: string
          const: VOID
        originalAmount:
          $ref: '#/components/schemas/AmountBreakdown'
          description: Amount in the original transaction currency
        amount:
          $ref: '#/components/schemas/AmountBreakdown'
          description: Amount charged to the cardholder
      required:
        - id
        - accountId
        - cardId
        - channel
        - digitalWallet
        - originalCurrency
        - currency
        - merchant
        - events
        - occurredAt
        - createdAt
        - updatedAt
        - status
        - originalAmount
        - amount
      description: Fully reversed authorization or zero-amount verification
    PostingEntry:
      type: object
      properties:
        virtualAssetId:
          type: string
          format: uuid
          description: Virtual asset ID
        amount:
          type: string
          description: Entry amount in the virtual asset denomination
        rateSnapshot:
          anyOf:
            - type: number
            - type: 'null'
          description: >-
            Billing-currency-per-unit rate applied to this entry. Populated for
            `SETTLEMENT` postings, `null` otherwise.
      required:
        - virtualAssetId
        - amount
        - rateSnapshot
    CardTransactionMerchant:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Merchant identifier
        name:
          type: string
          description: Merchant name
        city:
          anyOf:
            - type: string
            - type: 'null'
          description: Merchant city
        country:
          type: string
          minLength: 2
          maxLength: 2
          examples:
            - US
            - GB
            - DE
          description: ISO 3166-1 alpha-2 country code
        mccCode:
          type: string
          examples:
            - '5411'
            - '5812'
          description: Merchant Category Code
        mccCategory:
          type: string
          examples:
            - Grocery Stores
            - Eating Places & Restaurants
          description: MCC category description
      required:
        - id
        - name
        - city
        - mccCode
        - mccCategory
      description: Merchant details
    TransactionEvent:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Event identifier
        type:
          type: string
          enum:
            - AUTHORIZATION
            - CLEARING
            - REVERSAL
            - REFUND
            - DECLINE
          description: Lifecycle event type
          example: AUTHORIZATION
        originalAmount:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Event amount in the event-level original currency
        originalCurrency:
          type: string
          examples:
            - USD
            - HKD
            - EUR
          description: >-
            Per-event original currency. Usually equals the parent transaction
            `originalCurrency`, but can differ when the card network reports a
            presentment (typically a clearing) in the bill currency instead of
            the merchant local currency.
        amount:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Event amount charged to the cardholder (card currency)
        occurredAt:
          type: string
          examples:
            - '2024-01-15T10:30:00Z'
          description: ISO 8601 timestamp of when the event occurred
        createdAt:
          type: string
          examples:
            - '2024-01-15T10:30:05Z'
          description: ISO 8601 timestamp of when the event was recorded
      required:
        - id
        - type
        - originalAmount
        - originalCurrency
        - amount
        - occurredAt
        - createdAt
      description: A single lifecycle event on the transaction
    AmountBreakdown:
      type: object
      properties:
        authorized:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Original authorized amount before reversals
        reversed:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Total amount reversed (credited back)
        current:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Effective current amount (authorized - reversed, minimum 0)
      required:
        - authorized
        - reversed
        - current
      description: Amount breakdown showing authorized, reversed, and current values
    ClearedAmountBreakdown:
      type: object
      properties:
        cleared:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Total settled amount
        refunded:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Total amount refunded
        current:
          type: number
          minimum: 0
          examples:
            - 100.5
            - 0
            - 1234.99
          description: Effective current amount (cleared - refunded, minimum 0)
      required:
        - cleared
        - refunded
        - current
      description: Amount breakdown showing cleared, refunded, and current values
    DeclineReason:
      type: object
      properties:
        code:
          type: string
          enum:
            - INSUFFICIENT_BALANCE
            - INSUFFICIENT_MASTER_BALANCE
            - CARD_NOT_ACTIVE
            - CARD_NOT_ACTIVATED
            - CARD_EXPIRED
            - CARD_FROZEN
            - CARD_BLOCKED
            - CARD_REPORTED_LOST
            - CARD_REPORTED_STOLEN
            - ACCOUNT_NOT_ACTIVE
            - INCORRECT_PIN
            - INCORRECT_CVV
            - INVALID_CARD_DETAILS
            - CONTACTLESS_NOT_SUPPORTED
            - TERMINAL_ERROR
            - CASH_SERVICE_NOT_AVAILABLE
            - WITHDRAWALS_NOT_ALLOWED
            - ATM_WITHDRAWAL_LIMIT_EXCEEDED
            - ATM_WITHDRAWAL_FREQUENCY_EXCEEDED
            - MERCHANT_CARD_TYPE_MISMATCH
            - MERCHANT_CATEGORY_CODE_NOT_ALLOWED
            - TRANSACTION_TYPE_NOT_ALLOWED
            - MERCHANT_NOT_ALLOWED
            - CHANNEL_NOT_ALLOWED
            - TRANSACTION_AMOUNT_LIMIT_EXCEEDED
            - SPEND_LIMIT_EXCEEDED
            - AUTHORIZATION_COUNT_LIMIT_EXCEEDED
            - TRANSACTION_NOT_ALLOWED
            - NETWORK_DECLINE
            - SUSPECTED_FRAUD
            - INTERNAL_ERROR
          description: >-
            Machine-readable decline reason code. Intended for client
            application logic (routing the cardholder to a top-up screen,
            prompting for PIN re-entry, ...). Do not display this string to
            cardholders directly; use `message` instead, or render your own copy
            keyed off `code`.
          example: INSUFFICIENT_BALANCE
        message:
          type: string
          description: >-
            Cardholder-facing description of the decline reason. Safe to render
            directly in your UI as a sensible default.
      required:
        - code
        - message
      description: Reason the transaction was declined
    DeclinedPolicy:
      type: object
      properties:
        id:
          type: string
          description: >-
            ID of the policy that declined the transaction. A UUID for your
            policies; a stable identifier for platform policies.
        type:
          type: string
          enum:
            - MERCHANT_RESTRICTION
            - CHANNEL_RESTRICTION
            - TRANSACTION_AMOUNT_LIMIT
            - SPEND_LIMIT
            - AUTHORIZATION_COUNT_LIMIT
          example: MERCHANT_RESTRICTION
        scopeType:
          type: string
          enum:
            - PROJECT
            - USER
            - CARD
          description: The level the policy was attached to.
          example: PROJECT
        name:
          type: string
          minLength: 1
          maxLength: 128
          description: Human-readable label.
      required:
        - id
        - type
        - scopeType
        - name
      description: The policy that declined the transaction.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````