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

# Get transactions

> Returns a list of fiat transactions and their statuses



## OpenAPI

````yaml post /v1/users/{user_id}/fiat/status
openapi: 3.1.0
info:
  version: 0.0.1
  title: Privy API
  description: >-
    REST API for Privy's wallet infrastructure — provision and manage wallets
    across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and
    configure programmable policies and authorization intents.
  contact:
    name: Privy
    url: https://www.privy.io/
    email: support@privy.io
servers:
  - url: https://api.privy.io
security: []
tags:
  - name: Accounts
    description: Operations related to asset accounts
  - name: Aggregations
    description: Operations related to aggregations for tracking and measuring metrics
  - name: Apps
    description: Operations related to app settings and allowlist management
  - name: Client Auth
    description: OAuth token exchange and device authorization operations
  - name: Condition Sets
    description: Operations related to condition sets
  - name: Embedded wallets
    description: Operations related to embedded wallet creation and authentication
  - name: Fiat
    description: Operations related to fiat onramping and offramping
  - name: Intents
    description: Operations related to authorization intents for wallet actions
  - name: Key quorums
    description: Operations related to key quorums
  - name: Kraken Embed
    description: >-
      Operations for Kraken Embed integration, including quotes, trades, user
      management, and portfolio operations
  - name: OAuth
    description: >-
      OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for
      CLI and limited-input device login flows
  - name: Organizations
    description: Operations related to organization secret management
  - name: Policies
    description: Operations related to policies
  - name: Shared
    description: Common schemas shared across resources
  - name: Swaps
    description: Operations for swapping tokens within wallets
  - name: Transactions
    description: Operations related to transactions
  - name: User signers
    description: Operations related to user signers
  - name: Users
    description: Operations related to users
  - name: Wallet Actions
    description: Operations related to wallet actions
  - name: Wallets
    description: Operations related to wallets
  - name: Webhooks
    description: >-
      Webhook events that Privy sends to your configured endpoint when specific
      actions occur in your app
  - name: Yield
    description: >-
      Operations for depositing and withdrawing funds from ERC-4626 yield vaults
      (Morpho, Aave)
paths:
  /v1/users/{user_id}/fiat/status:
    post:
      tags:
        - Fiat
      summary: Get a list of fiat transactions and their statuses
      description: Returns a list of fiat transactions and their statuses
      operationId: listFiatTransactions
      parameters:
        - schema:
            type: string
            description: The ID of the user
          required: true
          name: user_id
          in: path
        - schema:
            type: string
            description: ID of your Privy app.
          required: true
          name: privy-app-id
          in: header
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                provider:
                  $ref: '#/components/schemas/OnrampProvider'
                tx_hash:
                  type: string
                  pattern: ^0x[0-9a-fA-F]+$
              required:
                - provider
      responses:
        '200':
          description: Bank deposit instructions for the onramp
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactions:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            type:
                              type: string
                              enum:
                                - onramp
                            created_at:
                              type: string
                            destination:
                              type: object
                              properties:
                                chain:
                                  type: string
                                currency:
                                  type: string
                                address:
                                  type: string
                                privy_user_id:
                                  type: string
                              required:
                                - chain
                                - currency
                                - address
                            receipt:
                              type: object
                              properties:
                                final_amount:
                                  type: string
                                transaction_hash:
                                  type: string
                              required:
                                - final_amount
                            is_sandbox:
                              type: boolean
                            id:
                              type: string
                            status:
                              $ref: '#/components/schemas/OnrampTransferStatus'
                            deposit_instructions:
                              $ref: '#/components/schemas/OnrampDepositInstructions'
                          required:
                            - type
                            - created_at
                            - destination
                            - is_sandbox
                            - id
                            - status
                            - deposit_instructions
                        - type: object
                          properties:
                            type:
                              type: string
                              enum:
                                - offramp
                            created_at:
                              type: string
                            destination:
                              type: object
                              properties:
                                payment_rail:
                                  type: string
                                currency:
                                  type: string
                                external_account_id:
                                  type: string
                              required:
                                - payment_rail
                                - currency
                                - external_account_id
                            receipt:
                              type: object
                              properties:
                                final_amount:
                                  type: string
                                transaction_hash:
                                  type: string
                              required:
                                - final_amount
                            is_sandbox:
                              type: boolean
                            id:
                              type: string
                            status:
                              $ref: '#/components/schemas/OnrampTransferStatus'
                            deposit_instructions:
                              $ref: '#/components/schemas/OfframpDepositInstructions'
                          required:
                            - type
                            - created_at
                            - destination
                            - is_sandbox
                            - id
                            - status
                            - deposit_instructions
                required:
                  - transactions
      security:
        - appSecretAuth: []
components:
  schemas:
    OnrampProvider:
      type: string
      enum:
        - bridge
        - bridge-sandbox
      description: Valid set of onramp providers
      title: OnrampProvider
      example: bridge
      x-stainless-model: client_auth.onramp_provider
    OnrampTransferStatus:
      type: string
      enum:
        - awaiting_funds
        - in_review
        - funds_received
        - payment_submitted
        - payment_processed
        - canceled
        - error
        - undeliverable
        - returned
        - refunded
      description: Status of an onramp or offramp transfer.
      title: OnrampTransferStatus
      x-stainless-model: fiat.onramp_transfer_status
    OnrampDepositInstructions:
      type: object
      properties:
        amount:
          type: string
        currency:
          $ref: '#/components/schemas/FiatCurrency'
        payment_rail:
          $ref: '#/components/schemas/FiatPaymentRail'
        deposit_message:
          type: string
        bank_name:
          type: string
        bank_account_number:
          type: string
        bank_routing_number:
          type: string
        bank_beneficiary_name:
          type: string
        bank_beneficiary_address:
          type: string
        bank_address:
          type: string
        iban:
          type: string
        bic:
          type: string
        account_holder_name:
          type: string
      required:
        - amount
        - currency
        - payment_rail
      description: Bank deposit instructions for an onramp transfer.
      title: OnrampDepositInstructions
      x-stainless-model: fiat.onramp_deposit_instructions
    OfframpDepositInstructions:
      type: object
      properties:
        amount:
          type: string
        currency:
          $ref: '#/components/schemas/OnrampAsset'
        chain:
          $ref: '#/components/schemas/OnrampChain'
        to_address:
          type: string
        from_address:
          type: string
      required:
        - amount
        - currency
        - chain
        - to_address
        - from_address
      description: Deposit instructions for an offramp transfer.
      title: OfframpDepositInstructions
      x-stainless-model: fiat.offramp_deposit_instructions
    FiatCurrency:
      type: string
      enum:
        - usd
        - eur
      description: Supported fiat currencies.
      title: FiatCurrency
      x-stainless-model: fiat.fiat_currency
    FiatPaymentRail:
      type: string
      enum:
        - sepa
        - ach_push
        - wire
      description: Supported fiat payment rails.
      title: FiatPaymentRail
      x-stainless-model: fiat.fiat_payment_rail
    OnrampAsset:
      type: string
      enum:
        - usdc
      description: Supported crypto assets for onramp and offramp.
      title: OnrampAsset
      x-stainless-model: fiat.onramp_asset
    OnrampChain:
      type: string
      enum:
        - ethereum
        - base
        - arbitrum
        - polygon
        - optimism
      description: Supported blockchain chains for onramp and offramp.
      title: OnrampChain
      x-stainless-model: fiat.onramp_chain
  securitySchemes:
    appSecretAuth:
      type: http
      scheme: basic
      description: >-
        Basic Auth header with your app ID as the username and your app secret
        as the password.

````