> ## 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 get



## OpenAPI

````yaml /api-reference/openapi.json get /v1/transactions/{reference}
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/{reference}:
    get:
      tags:
        - transactions
      summary: Transactions get
      operationId: transactions-get
      parameters:
        - in: path
          name: reference
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTransactionResponse'
          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':
          description: >-
            Authenticated but lacking the required permission, or an
            impersonated session attempting a write (code:
            impersonation_write_blocked).
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
          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:
    GetTransactionResponse:
      properties:
        amount:
          format: double
          nullable: true
          type: number
        beneficiaryAlias:
          nullable: true
          type: string
        beneficiaryId:
          format: uuid
          nullable: true
          type: string
        category:
          enum:
            - Deposit
            - Withdrawal
            - Conversion
          type: string
        createdAt:
          format: date-time
          type: string
        creditorDetails:
          $ref: '#/components/schemas/BankAccountDetailsDto'
        currency:
          type: string
        debtorDetails:
          $ref: '#/components/schemas/BankAccountDetailsDto'
        description:
          nullable: true
          type: string
        direction:
          enum:
            - Internal
            - Inward
            - Outward
          type: string
        endToEndId:
          type: string
        errorKey:
          enum:
            - Failed
            - Expired
            - BankRejection
            - BankUnreachable
            - InvalidAccountDetails
            - CurrencyNotAccepted
            - InvalidWalletAddress
            - RecipientBlocked
          nullable: true
          type: string
        fxQuoteExpiryTime:
          format: date-time
          nullable: true
          type: string
        hasFx:
          type: boolean
        idempotencyKey:
          nullable: true
          type: string
        method:
          enum:
            - Fiat
            - Token
          type: string
        partnerUser:
          $ref: '#/components/schemas/UserDetailsDto'
        partyType:
          enum:
            - Partner
            - Customer
          type: string
        rail:
          enum:
            - Sepa
            - Swift
            - Wallet
          nullable: true
          type: string
        reference:
          type: string
        sessionId:
          type: string
        status:
          enum:
            - Pending
            - Completed
            - Unsuccessful
            - Cancelled
            - Expired
          type: string
        timeline:
          items:
            $ref: '#/components/schemas/TimelineDto'
          type: array
        transactionHash:
          nullable: true
          type: string
        type:
          enum:
            - NotDefined
            - PartnerCustomerDeposit
            - PartnerCustomerWithdraw
            - PartnerDeposit
            - PartnerWithdraw
            - PartnerCustomerRefund
            - TokenTransferOut
            - TokenTransferIn
            - CustomerDeposit
            - CustomerWithdraw
            - CustomerRefund
            - Conversion
          type: string
        updatedAt:
          format: date-time
          nullable: true
          type: string
        userAmount:
          format: double
          nullable: true
          type: number
        userCurrency:
          nullable: true
          type: string
        userReference:
          nullable: true
          type: string
        websiteReference:
          type: string
      required:
        - status
        - type
        - method
        - partyType
        - category
        - direction
        - reference
        - createdAt
        - updatedAt
        - currency
        - amount
        - partnerUser
        - debtorDetails
        - creditorDetails
        - endToEndId
        - sessionId
        - websiteReference
        - hasFx
        - fxQuoteExpiryTime
        - userCurrency
        - userAmount
      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
    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
    UserDetailsDto:
      properties:
        address:
          type: string
        country:
          type: string
        countryCode:
          type: string
        email:
          type: string
        id:
          type: string
        ipAddress:
          type: string
        name:
          type: string
      required:
        - id
        - name
        - email
        - address
        - countryCode
        - country
        - ipAddress
      type: object
    TimelineDto:
      properties:
        createdAt:
          format: date-time
          type: string
        status:
          enum:
            - Pending
            - Completed
            - Unsuccessful
            - Cancelled
            - Expired
          type: string
        step:
          enum:
            - Created
            - Initiated
            - Processing
            - Completed
            - Failed
            - Submitted
            - Received
          type: string
      required:
        - status
        - step
        - createdAt
      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

````