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

# Transactions list



## OpenAPI

````yaml /api-reference/openapi.json get /v1/transactions
openapi: 3.0.4
info:
  description: >-
    Public API for the StableMint platform. Every request is authenticated with
    a service-account RSA signature over a canonical string; bearer tokens are
    not accepted.
  title: StableMint API
  version: v1
servers:
  - description: Production
    url: https://api.stablemint.io
  - description: Sandbox
    url: https://api.stablemint.net
security: []
tags:
  - name: accounts
  - name: beneficiaries
  - name: checkout
  - name: customers
  - name: fx
  - name: payouts
  - name: reports
  - name: simulations
  - name: transactions
  - name: users
  - name: wallets
  - name: webhooks
paths:
  /v1/transactions:
    get:
      tags:
        - transactions
      summary: Transactions list
      operationId: transactions-list
      parameters:
        - in: query
          name: scope
          schema:
            enum:
              - Partner
              - Customer
              - All
            type: string
        - in: query
          name: partnerCustomerGuid
          schema:
            format: uuid
            type: string
        - in: query
          name: page
          schema:
            format: int32
            type: integer
        - in: query
          name: pageSize
          schema:
            format: int32
            type: integer
        - in: query
          name: direction
          schema:
            enum:
              - Internal
              - Inward
              - Outward
            type: string
        - in: query
          name: from
          schema:
            format: date-time
            type: string
        - in: query
          name: to
          schema:
            format: date-time
            type: string
        - in: query
          name: status
          schema:
            enum:
              - Pending
              - Completed
              - Unsuccessful
              - Cancelled
              - Expired
            type: string
        - in: query
          name: minAmount
          schema:
            format: double
            type: number
        - in: query
          name: maxAmount
          schema:
            format: double
            type: number
        - in: query
          name: currency
          schema:
            type: string
        - in: query
          name: type
          schema:
            enum:
              - NotDefined
              - PartnerCustomerDeposit
              - PartnerCustomerWithdraw
              - PartnerDeposit
              - PartnerWithdraw
              - PartnerCustomerRefund
              - TokenTransferOut
              - TokenTransferIn
              - CustomerDeposit
              - CustomerWithdraw
              - CustomerRefund
              - Conversion
            type: string
        - in: query
          name: category
          schema:
            enum:
              - Deposit
              - Withdrawal
              - Conversion
            type: string
        - in: query
          name: method
          schema:
            enum:
              - Fiat
              - Token
            type: string
        - in: query
          name: partyType
          schema:
            enum:
              - Partner
              - Customer
            type: string
        - in: query
          name: sortBy
          schema:
            enum:
              - Date
              - Amount
              - Status
              - Type
              - MonitorResultStatus
              - UpdatedDate
            type: string
        - in: query
          name: sortDirection
          schema:
            enum:
              - Ascending
              - Descending
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueryPaginatedResultOfTransactionItemDto'
          description: OK
        '400':
          description: Malformed request
        '401':
          description: >-
            No service-account credentials (code: signature_required), a Clerk
            bearer token was sent (code: jwt_not_accepted) — both rejected by
            the gateway — or the RSA signature, timestamp window or nonce failed
            verification downstream.
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          description: >-
            Authenticated but lacking the required permission, or an
            impersonated session attempting a write (code:
            impersonation_write_blocked).
        '404':
          description: >-
            No such resource. Also returned by the gateway itself when a path
            parameter fails its route constraint.
        '500':
          description: Unhandled downstream error
        '502':
          description: >-
            Gateway could not reach the downstream service or received an
            invalid response from it.
        '504':
          description: Downstream service did not respond in time.
      security:
        - ApiKey: []
          Nonce: []
          Signature: []
          Timestamp: []
components:
  schemas:
    QueryPaginatedResultOfTransactionItemDto:
      properties:
        hasNextPage:
          type: boolean
        hasPreviousPage:
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/TransactionItemDto'
          type: array
        pageNumber:
          format: int32
          type: integer
        pageSize:
          format: int32
          type: integer
        totalCount:
          format: int32
          type: integer
        totalPages:
          format: int32
          type: integer
      type: object
    ProblemDetails:
      properties:
        detail:
          nullable: true
          type: string
        instance:
          nullable: true
          type: string
        status:
          format: int32
          nullable: true
          type: integer
        title:
          nullable: true
          type: string
        type:
          nullable: true
          type: string
      type: object
    TransactionItemDto:
      properties:
        amount:
          format: double
          nullable: true
          type: number
        bank:
          nullable: true
          type: string
        blockchainDestinationAddress:
          nullable: true
          type: string
        blockchainTransactionHash:
          nullable: true
          type: string
        category:
          enum:
            - Deposit
            - Withdrawal
            - Conversion
          type: string
        counterPartyAccount:
          nullable: true
          type: string
        counterPartyName:
          nullable: true
          type: string
        creditorDetails:
          $ref: '#/components/schemas/BankAccountDetailsDto'
        currency:
          type: string
        date:
          format: date-time
          type: string
        debtorDetails:
          $ref: '#/components/schemas/BankAccountDetailsDto'
        id:
          format: int64
          type: integer
        initiatedDate:
          format: date-time
          nullable: true
          type: string
        isInitiated:
          nullable: true
          type: boolean
        method:
          enum:
            - Fiat
            - Token
          type: string
        partnerUserId:
          nullable: true
          type: string
        partyType:
          enum:
            - Partner
            - Customer
          type: string
        reference:
          type: string
        settlementDate:
          format: date-time
          nullable: true
          type: string
        status:
          enum:
            - Pending
            - Completed
            - Unsuccessful
            - Cancelled
            - Expired
          nullable: true
          type: string
        transactionDirection:
          enum:
            - Internal
            - Inward
            - Outward
          type: string
        transactionType:
          enum:
            - NotDefined
            - PartnerCustomerDeposit
            - PartnerCustomerWithdraw
            - PartnerDeposit
            - PartnerWithdraw
            - PartnerCustomerRefund
            - TokenTransferOut
            - TokenTransferIn
            - CustomerDeposit
            - CustomerWithdraw
            - CustomerRefund
            - Conversion
          type: string
        userCurrency:
          type: string
      required:
        - currency
        - userCurrency
        - reference
        - debtorDetails
        - creditorDetails
      type: object
    BankAccountDetailsDto:
      properties:
        accountHolderName:
          nullable: true
          type: string
        address:
          nullable: true
          type: string
        bankName:
          type: string
        bic:
          nullable: true
          type: string
        country:
          nullable: true
          type: string
        iban:
          nullable: true
          type: string
        walletAddress:
          nullable: true
          type: string
      required:
        - iban
        - bic
        - bankName
      type: object
  securitySchemes:
    ApiKey:
      description: The service account's API key.
      in: header
      name: ApiKey
      type: apiKey
    Nonce:
      description: A GUID, single-use. A replayed nonce is rejected.
      in: header
      name: Nonce
      type: apiKey
    Signature:
      description: >-
        Base64 RSA/SHA-256 (PKCS#1 v1.5) signature over the canonical string:
        METHOD, path, canonical query, Timestamp, Nonce, API secret and the
        lowercase hex SHA-256 of the raw body, joined with LF. Sign the PUBLIC
        path exactly as called (e.g. /v1/webhooks), not any internal path.
      in: header
      name: Signature
      type: apiKey
    Timestamp:
      description: Unix seconds. Rejected outside the server's tolerance window.
      in: header
      name: Timestamp
      type: apiKey

````