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

# List transactions for a customer virtual account

> Activity history for a Bridge-backed USD/EUR virtual account. Fees, receipts, and sender PII are excluded from the response.




## OpenAPI

````yaml /api-reference/openapi.json get /v1/customers/{customerId}/virtual-accounts/{virtualAccountId}/transactions
openapi: 3.0.3
info:
  title: XentFi API
  version: 1.0.0
  description: >-
    API documentation for XentFi.The XentFi API gives you access to pretty much
    all the features you can use on our dashboard and lets you extend them for
    use in your application. It strives to be RESTful and is organized around
    the main resources you would be interacting with - with a few notable
    exceptions.
servers:
  - url: https://api.xentfi.com
    description: Production server
security: []
tags: []
paths:
  /v1/customers/{customerId}/virtual-accounts/{virtualAccountId}/transactions:
    get:
      tags:
        - USD and EUR Virtual Accounts
      summary: List transactions for a customer virtual account
      description: >
        Activity history for a Bridge-backed USD/EUR virtual account. Fees,
        receipts, and sender PII are excluded from the response.
      operationId: listCustomerVirtualAccountTransactions
      parameters:
        - name: customerId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: virtualAccountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: cursor
          in: query
          description: >
            Last event id from the previous page — returns the next page ordered
            newest-to-oldest.
          schema:
            type: string
        - name: eventType
          in: query
          schema:
            type: string
            enum:
              - funds_received
              - payment_submitted
              - payment_processed
              - in_review
              - refund
              - refund_in_flight
              - refund_failed
              - microdeposit
              - account_update
              - deactivation
              - activation
      responses:
        '200':
          description: Activity for this Bridge virtual account
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - count
                  - hasMore
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      description: >
                        Transaction on a Bridge-backed virtual account (USD /
                        EUR). Source: Bridge Virtual Account Activity.
                        Provider-specific internal fields (developer fee,
                        exchange fee, gas fee, receipt breakdown, sender bank
                        PII) are intentionally omitted.
                      properties:
                        id:
                          type: string
                          format: uuid
                        type:
                          type: string
                          description: >
                            Bridge event type — `funds_received`,
                            `payment_submitted`, `payment_processed`,
                            `in_review`, `refund`, `refund_in_flight`,
                            `refund_failed`, `microdeposit`, `account_update`,
                            `deactivation`, or `activation`.
                        status:
                          type: string
                          description: >
                            Mirrors `type`. Bridge encodes the state in the
                            event type itself (there is no separate status
                            field).
                        amount:
                          type: string
                        currency:
                          type: string
                          description: ISO currency code, upper-case (e.g. `USD`, `USDC`).
                        depositId:
                          type: string
                          nullable: true
                          description: >
                            Deposit id linking this event to the originating
                            fiat deposit. Multiple events can share the same
                            `depositId`.
                        txHash:
                          type: string
                          nullable: true
                          description: >-
                            On-chain destination hash, when the payout has been
                            delivered.
                        destinationPaymentRail:
                          type: string
                          nullable: true
                          example: base
                        createdAt:
                          type: string
                          format: date-time
                  count:
                    type: integer
                    description: Total number of activity events.
                  hasMore:
                    type: boolean
                    description: >
                      True when a full page was returned — pass the last item's
                      `id` as `cursor` to fetch the next page.
                  nextCursor:
                    type: string
                    nullable: true
                    description: >
                      Opaque cursor for the next page. `null` when the current
                      page is the last.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
        '404':
          description: Virtual account not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Wallet not found
                      timestamp:
                        type: string
                        format: date-time
                      requestId:
                        type: string
      security:
        - ApiKeyAuth: []
          OrgIdAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apiKey
    OrgIdAuth:
      type: apiKey
      in: header
      name: orgId

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.