> ## 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 an NGN virtual account

> Returns the auto-swap transactions created from deposits into the account's static NGN bank account. Fee breakdowns and the payer's customer profile are excluded from the response.




## OpenAPI

````yaml /api-reference/openapi.json get /v1/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/virtual-accounts/{virtualAccountId}/transactions:
    get:
      tags:
        - NGN Virtual Accounts
      summary: List transactions for an NGN virtual account
      description: >
        Returns the auto-swap transactions created from deposits into the
        account's static NGN bank account. Fee breakdowns and the payer's
        customer profile are excluded from the response.
      operationId: listVirtualAccountTransactions
      parameters:
        - name: virtualAccountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: perPage
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
      responses:
        '200':
          description: Transactions for this NGN virtual account
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - count
                  - hasMore
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      description: >
                        Auto-swap transaction created from deposits into a
                        Quidax NGN static virtual account. Source: Quidax Auto
                        Swap Transactions. Blockchain fee breakdowns, processor
                        fee, and the payer's customer profile (name, email) are
                        intentionally omitted.
                      properties:
                        id:
                          type: string
                          format: uuid
                        status:
                          type: string
                          description: >
                            Auto-swap status — `pending`, `completed`, or
                            `failed`.
                        mode:
                          type: string
                          description: buy (fiat → crypto) or sell
                        fromCurrency:
                          type: string
                          description: Source currency — always `NGN`.
                        toCurrency:
                          type: string
                          description: Destination currency — e.g. `USDT`, `USDC`.
                        fromAmount:
                          type: string
                          description: Amount the payer deposited, in `fromCurrency`.
                        toAmount:
                          type: string
                          description: >-
                            Crypto credited to the destination wallet, in
                            `toCurrency`.
                        network:
                          type: string
                          nullable: true
                          example: erc20
                        txHash:
                          type: string
                          nullable: true
                          description: >-
                            On-chain payout hash, populated once the crypto leg
                            is broadcast.
                        depositStatus:
                          type: string
                          nullable: true
                          description: >-
                            Status of the underlying fiat deposit (`success` /
                            `pending` / `failed`).
                        depositFee:
                          type: string
                          nullable: true
                          description: Fiat processor fee charged on the deposit.
                        errorMessage:
                          type: string
                          nullable: true
                          description: Populated only when the auto-swap failed.
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                  count:
                    type: integer
                    description: Total number of transactions across all pages.
                  hasMore:
                    type: boolean
                    description: >
                      True when more pages are available. Derived from `page <
                      totalPages` in the provider response.
                  nextPage:
                    type: integer
                    nullable: true
                    description: >
                      Page number to request next. `null` when there are no
                      further pages.
        '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.