> ## Documentation Index
> Fetch the complete documentation index at: https://rain-sandbox-trial.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get all transactions



## OpenAPI

````yaml get /issuing/transactions
openapi: 3.0.3
info:
  title: Issuing API
  description: This is the specification for Rain's Issuing API.
  termsOfService: https://www.rain.xyz/legal/authorized-user-terms
  contact:
    email: support@rain.xyz
  version: 1.3.0
servers:
  - url: https://api-dev.rain.xyz/v1
    description: Sandbox server
  - url: https://api.rain.xyz/v1
    description: Production server
security: []
tags:
  - name: paymentRoutes
    description: >-
      **Endpoint Migration:** The `/v1/automations` endpoints have been renamed
      to `/v1/payment-routes`. The old `/v1/automations` paths remain available
      as deprecated aliases during migration. Update your integrations to use
      `/v1/payment-routes` as the deprecated endpoints will be removed in a
      future release.
  - name: simulate
    description: >-
      Transaction simulation endpoints for testing integration flows in
      non-production environments. These endpoints let you trigger transaction
      events programmatically to automate integration tests and verify webhook
      handling without depending on external systems or staging real deposits.
      **Sandbox only** — all simulation endpoints return `404 Not Found` in
      production.
  - name: raindrops
    description: >-
      Rewards and points management endpoints. Custom API keys need
      `raindrops:read`/`raindrops:write` for general rewards endpoints and
      `raindrops-travel:read`/`raindrops-travel:write` for travel redemption
      endpoints.
    x-group: rewards
paths:
  /issuing/transactions:
    get:
      tags:
        - transactions
      summary: Get all transactions
      operationId: getIssuingTransactions
      parameters:
        - name: companyId
          in: query
          description: For corporate cards, id of the company to get transactions for
          required: false
          schema:
            type: string
            format: uuid
        - name: userId
          in: query
          description: Id of the user to get transactions for
          required: false
          schema:
            type: string
            format: uuid
        - name: cardId
          in: query
          description: Id of the card to get transactions for
          required: false
          schema:
            type: string
            format: uuid
        - name: type
          in: query
          description: Type of transaction to get
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - spend
                - collateral
                - payment
                - fee
                - transfer
        - name: transactionHash
          in: query
          description: Hash of the transaction to get
          required: false
          schema:
            type: string
        - name: authorizedBefore
          in: query
          description: Get transactions authorized before this date
          required: false
          schema:
            type: string
            format: date-time
        - name: authorizedAfter
          in: query
          description: Get transactions authorized after this date
          required: false
          schema:
            type: string
            format: date-time
        - name: postedBefore
          in: query
          description: Get transactions posted before this date
          required: false
          schema:
            type: string
            format: date-time
        - name: postedAfter
          in: query
          description: Get transactions posted after this date
          required: false
          schema:
            type: string
            format: date-time
        - $ref: '#/components/parameters/cursorParam'
        - $ref: '#/components/parameters/limitParam'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IssuingTransaction'
        '401':
          description: Invalid authorization
        '403':
          description: Forbidden
        '404':
          description: User not found
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  parameters:
    cursorParam:
      name: cursor
      in: query
      description: The id of the resource after which to start fetching
      required: false
      schema:
        type: string
    limitParam:
      name: limit
      in: query
      description: The number of resources to fetch
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
  schemas:
    IssuingTransaction:
      oneOf:
        - type: object
          required:
            - id
            - type
            - spend
          properties:
            id:
              type: string
              format: uuid
              description: The id of the transaction
            type:
              type: string
              enum:
                - spend
              description: The type of transaction
            spend:
              type: object
              description: The spend transaction
              required:
                - amount
                - currency
                - receipt
                - merchantName
                - merchantCategory
                - merchantCategoryCode
                - cardId
                - cardType
                - userId
                - userFirstName
                - userEmail
                - status
                - authorizedAt
              properties:
                amount:
                  type: integer
                  description: The amount of the transaction, in cents
                currency:
                  type: string
                  description: The currency of the transaction
                localAmount:
                  type: integer
                  description: >-
                    The transaction amount in local currency divided by 100 for
                    all currencies except Vietnamese dong (VND) and Ugandan
                    shilling (UGX), which are stored as whole amounts.
                localCurrency:
                  type: string
                  description: The local currency of the transaction
                authorizedAmount:
                  type: integer
                  description: The authorized amount of the transaction, in cents
                authorizationMethod:
                  type: string
                  description: The method of authorization
                memo:
                  type: string
                  description: The memo of the transaction
                receipt:
                  type: boolean
                  default: false
                  description: Whether the transaction has a receipt
                merchantName:
                  type: string
                  description: The name of the merchant
                merchantCategory:
                  type: string
                  description: The category of the merchant
                merchantCategoryCode:
                  type: string
                  description: The category code of the merchant
                merchantId:
                  type: string
                  description: >-
                    A unique identifier composed of concatenated merchant
                    identification fields
                enrichedMerchantIcon:
                  type: string
                  description: The enriched icon of the merchant
                enrichedMerchantName:
                  type: string
                  description: The enriched name of the merchant
                enrichedMerchantCategory:
                  type: string
                  description: The enriched category of the merchant
                cardId:
                  type: string
                  format: uuid
                  description: The id of the card that the transaction was made on
                cardType:
                  type: string
                  enum:
                    - physical
                    - virtual
                  description: The type of card that the transaction was made on
                companyId:
                  type: string
                  format: uuid
                  description: The id of the company that the transaction was made under
                userId:
                  type: string
                  format: uuid
                  description: The id of the user that made the transaction
                userFirstName:
                  type: string
                  description: The first name of the user that made the transaction
                userLastName:
                  type: string
                  description: The last name of the user that made the transaction
                userEmail:
                  type: string
                  description: The email of the user that made the transaction
                status:
                  type: string
                  enum:
                    - pending
                    - reversed
                    - declined
                    - completed
                  description: The status of the transaction
                declinedReason:
                  type: string
                  description: The reason the transaction was declined
                authorizedAt:
                  type: string
                  description: The time that the transaction was authorized
                postedAt:
                  type: string
                  description: The time that the transaction was posted
                isForcePosted:
                  type: boolean
                  description: >-
                    Indicates whether this transaction was force posted (settled
                    without a prior authorization)
                closedAuthorizationTransactionId:
                  type: string
                  format: uuid
                  description: >-
                    For force-posted transactions with a prior authorization,
                    the ID of the original closed authorization transaction
                refundMethod:
                  type: string
                  enum:
                    - onchain_refund
                    - spending_credit
                  description: >-
                    Indicates how the transaction was refunded. Present only for
                    refund transactions.
                referenceInfo:
                  type: object
                  description: >-
                    Blockchain reference details for on-chain refunds. Present
                    only when refundMethod is onchain_refund and the on-chain
                    transaction has settled.
                  required:
                    - reference
                    - rail
                  properties:
                    reference:
                      type: string
                      description: The on-chain transaction hash
                    rail:
                      type: string
                      description: The chain identifier (e.g., evm:1, evm:137)
        - type: object
          required:
            - id
            - type
            - collateral
          properties:
            id:
              type: string
              format: uuid
              description: The id of the transaction
            type:
              type: string
              enum:
                - collateral
            collateral:
              type: object
              description: The collateral transaction
              required:
                - amount
                - currency
                - chainId
                - walletAddress
                - transactionHash
              properties:
                amount:
                  type: number
                  description: The amount of the transaction, in cents
                currency:
                  type: string
                  description: The currency of the transaction
                memo:
                  type: string
                  description: The memo of the transaction
                chainId:
                  type: integer
                  description: >-
                    The chain id - as a parsed base-10 number - that the
                    transaction is on
                walletAddress:
                  $ref: '#/components/schemas/EvmOrSolanaWalletAddress'
                  description: The wallet address the collateral was added from
                transactionHash:
                  $ref: '#/components/schemas/EvmOrSolanaTransactionHash'
                  description: The hash of the collateral transaction
                companyId:
                  type: string
                  format: uuid
                  description: The id of the company that the transaction was made under
                userId:
                  type: string
                  format: uuid
                  description: The id of the user that the transaction was made under
                postedAt:
                  type: string
                  format: date-time
                  description: The time that the transaction was posted
        - type: object
          required:
            - id
            - type
            - payment
          properties:
            id:
              type: string
              format: uuid
              description: The id of the transaction
            type:
              type: string
              enum:
                - payment
            payment:
              type: object
              description: The payment transaction
              required:
                - amount
                - currency
                - status
              properties:
                amount:
                  type: integer
                  description: The amount of the transaction, in cents
                currency:
                  type: string
                  description: The currency of the transaction
                memo:
                  type: string
                  description: The memo of the transaction
                chainId:
                  type: integer
                  description: >-
                    The chain id - as a parsed base-10 number - that the
                    transaction is on
                walletAddress:
                  $ref: '#/components/schemas/EvmOrSolanaWalletAddress'
                  description: The wallet address the payment was made from
                transactionHash:
                  $ref: '#/components/schemas/EvmOrSolanaTransactionHash'
                  description: The hash of the payment transaction
                companyId:
                  type: string
                  format: uuid
                  description: The id of the company that the transaction was made under
                userId:
                  type: string
                  format: uuid
                  description: The id of the user that the transaction was made under
                status:
                  type: string
                  enum:
                    - pending
                    - completed
                  description: The status of the transaction
                postedAt:
                  type: string
                  description: The time that the transaction was posted
        - type: object
          required:
            - id
            - type
            - fee
          properties:
            id:
              type: string
              format: uuid
              description: The id of the transaction
            type:
              type: string
              enum:
                - fee
            fee:
              type: object
              description: The fee transaction
              required:
                - amount
                - currency
                - status
              properties:
                amount:
                  type: integer
                  description: The amount of the fee, in cents
                description:
                  type: string
                  description: The description of the fee
                companyId:
                  type: string
                  format: uuid
                  description: The id of the company that the fee was charged to
                userId:
                  type: string
                  format: uuid
                  description: The id of the user that the fee was charged to
                postedAt:
                  type: string
                  format: date-time
                  description: The time that the fee was posted
        - type: object
          required:
            - id
            - type
            - transfer
          properties:
            id:
              type: string
              format: uuid
              description: The id of the transaction
            type:
              type: string
              enum:
                - transfer
            transfer:
              $ref: '#/components/schemas/TransferDetails'
    EvmOrSolanaWalletAddress:
      type: string
      pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$
    EvmOrSolanaTransactionHash:
      type: string
      pattern: ^(0x[0-9a-fA-F]{64}|[1-9A-HJ-NP-Za-km-z]{64,128})$
    TransferDetails:
      type: object
      description: Transfer details within a transaction response
      required:
        - source
        - destination
        - exchangeRate
        - fees
        - quoteId
        - status
        - createdAt
        - updatedAt
        - expiresAt
      properties:
        userId:
          type: string
          format: uuid
          description: User ID for consumer accounts. Mutually exclusive with companyId.
        companyId:
          type: string
          format: uuid
          description: Company ID for corporate accounts. Mutually exclusive with userId.
        source:
          $ref: '#/components/schemas/TransferSource'
        destination:
          $ref: '#/components/schemas/TransferDestination'
        exchangeRate:
          type: number
          description: Exchange rate excluding fees
        fees:
          $ref: '#/components/schemas/FeeDetail'
        quoteId:
          type: string
          format: uuid
          description: Quote ID used to create this transfer
        status:
          $ref: '#/components/schemas/TransferStatus'
        createdAt:
          type: string
          format: date-time
          description: When the transfer was created
        updatedAt:
          type: string
          format: date-time
          description: When the transfer was last updated
        expiresAt:
          type: string
          format: date-time
          description: When the transfer expires
        depositAddress:
          $ref: '#/components/schemas/TransferOnchainDepositAddress'
        transferMessage:
          type: string
          description: Optional message for the transfer
    TransferSource:
      type: object
      required:
        - currency
        - rail
        - amount
      properties:
        currency:
          $ref: '#/components/schemas/CryptoCurrency'
        rail:
          $ref: '#/components/schemas/CryptoRail'
        amount:
          type: string
          pattern: ^[0-9]+(\.[0-9]+)?$
          description: Amount sent (decimal string)
    TransferDestination:
      oneOf:
        - title: Onchain Destination
          type: object
          description: Onchain destination with direct wallet address
          required:
            - currency
            - rail
            - amount
            - address
          properties:
            currency:
              $ref: '#/components/schemas/CryptoCurrency'
            rail:
              $ref: '#/components/schemas/CryptoRail'
            amount:
              type: string
              pattern: ^[0-9]+(\.[0-9]+)?$
              description: Amount to receive (decimal string)
            address:
              $ref: '#/components/schemas/OnchainAddress'
        - title: Fiat Destination
          type: object
          description: >-
            Fiat destination via payment account (resolves to
            PaymentAccountExternalFiatAccount details by id)
          required:
            - currency
            - rail
            - amount
            - address
          properties:
            currency:
              $ref: '#/components/schemas/FiatCurrency'
            rail:
              $ref: '#/components/schemas/FiatRail'
            amount:
              type: string
              pattern: ^[0-9]+(\.[0-9]+)?$
              description: Amount to receive (decimal string)
            address:
              $ref: '#/components/schemas/PaymentAccountAddress'
            referenceId:
              type: string
              description: Optional reference ID for the fiat transfer
    FeeDetail:
      type: object
      description: Fee breakdown for a transfer
      properties:
        rain:
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
          description: >-
            Rain's fee for the transaction, charged to the partner
            (informational)
        sender:
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
          description: >-
            Sender fee deducted from the end user's sent amount. See [Sender
            Fees](/docs/sender-fees) for details.
        developer:
          allOf:
            - $ref: '#/components/schemas/FeeAmount'
          deprecated: true
          description: Deprecated alias of `sender`; carries the same values.
    TransferStatus:
      type: string
      enum:
        - pending
        - awaiting_transfer
        - processing
        - settled
        - failed
        - cancelled
        - expired
        - refunded
      description: Current status of the transfer
    TransferOnchainDepositAddress:
      type: object
      required:
        - type
        - address
      properties:
        type:
          type: string
          enum:
            - onchain
          description: Deposit address type
        address:
          type: string
          description: Wallet address to send crypto to
    CryptoCurrency:
      type: string
      enum:
        - usdc
        - rusd
      description: Supported cryptocurrencies
    CryptoRail:
      type: string
      enum:
        - ethereum
        - polygon
        - optimism
        - arbitrum
        - base
        - solana
      description: Supported blockchain networks for crypto operations
    OnchainAddress:
      title: Onchain Address
      type: object
      required:
        - type
        - address
      properties:
        type:
          type: string
          enum:
            - onchain
        address:
          type: string
          description: The blockchain address. Format depends on rail.
    FiatCurrency:
      type: string
      enum:
        - usd
      description: Supported fiat currencies
    FiatRail:
      type: string
      enum:
        - ach
        - wire
      description: Supported fiat payment rails
    PaymentAccountAddress:
      title: Payment Account Id
      type: object
      description: >-
        Reference to a payment account by ID; the account holds
        `PaymentAccountExternalFiatAccountDetails` (external fiat bank account).
      required:
        - type
        - id
      properties:
        type:
          type: string
          enum:
            - paymentAccount
        id:
          type: string
          format: uuid
          description: The payment account ID
    FeeAmount:
      type: object
      description: Fee amount details
      required:
        - currency
        - amount
        - amountUSD
      properties:
        currency:
          type: string
          description: Currency the fee was charged in
        amount:
          type: string
          pattern: ^[0-9]+(\.[0-9]+)?$
          description: Fee amount in the original currency (decimal string)
        amountUSD:
          type: string
          pattern: ^[0-9]+(\.[0-9]+)?$
          description: Fee amount computed in USD at time of transfer (decimal string)
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: Api-Key
      in: header

````