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

# List virtual accounts

> Where a payer sends fiat to fund your balance in this asset: the bank accounts Jenzy holds for you. Read-only — Jenzy enables collections in an asset for you; ask if the list is empty. Bank pay-ins carry no payer identity, so tell your payer to keep their own record of what they sent.



## OpenAPI

````yaml /v2/openapi.json get /virtual-accounts
openapi: 3.1.0
info:
  title: Jenzy Hermes Multi-asset API
  version: 2.0.0
  description: >-
    Hold and pay out across the assets enabled for your organization. Every
    amount is an exact decimal string beside an `asset` field. Authenticate with
    the same `jz_live_…` API key as `/v1`.
servers:
  - url: https://api.jenzy.com/v2
    description: Production
security: []
paths:
  /virtual-accounts:
    get:
      summary: List virtual accounts
      description: >-
        Where a payer sends fiat to fund your balance in this asset: the bank
        accounts Jenzy holds for you. Read-only — Jenzy enables collections in
        an asset for you; ask if the list is empty. Bank pay-ins carry no payer
        identity, so tell your payer to keep their own record of what they sent.
      parameters:
        - schema:
            type: string
            minLength: 1
            description: >-
              An asset code as `GET /v2/assets` lists it — uppercase, never
              compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
              live on the payment object.
            example: USDC
          required: true
          description: >-
            An asset code as `GET /v2/assets` lists it — uppercase, never
            compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
            live on the payment object.
          name: asset
          in: query
        - $ref: '#/components/parameters/HermesOrg'
      responses:
        '200':
          description: Your coordinates in this asset — `active` and `pending` ones.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VirtualAccountList'
        '400':
          description: '`asset` is required.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Missing, malformed, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: >-
            Organization suspended, request IP not on the allowlist, or no
            multi-asset access yet (`onboarding_incomplete` /
            `access_suspended`). For `asset=USD`: USD collections are not
            enabled for your organization yet (`corridor_not_enabled`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Not an asset enabled for your organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '422':
          description: >-
            A stablecoin has no virtual account (`unsupported_asset`) — use
            `POST /v2/deposit-addresses`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: The `/v2` shutter is closed — check `GET /v2/ping`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    HermesOrg:
      name: HERMES-ORG
      in: header
      required: false
      description: >-
        The id of one of your Child orgs. The call then acts on that Child org,
        not on your organization. If you do not send it, the call acts on your
        organization. An id that is not one of your Child orgs gives `404`.
      schema:
        type: string
        format: uuid
        example: 3f1c2a9e-8b7d-4e21-9a6f-0c5d4b3e2a10
  schemas:
    VirtualAccountList:
      type: object
      properties:
        virtual_accounts:
          type: array
          items:
            $ref: '#/components/schemas/VirtualAccount'
      required:
        - virtual_accounts
      description: >-
        Your collection coordinates in one asset. Empty until Jenzy enables
        collections for you in it.
    ErrorEnvelope:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_error
                - unauthorized
                - forbidden
                - not_found
                - conflict
                - rate_limited
                - internal_error
                - unknown_institution
                - invalid_mobile_number
                - invalid_account_number
                - mobile_number_institution_mismatch
                - service_unavailable
                - sandbox_only
                - insufficient_funds
                - rail_disabled
                - amount_limit_exceeded
                - org_limit_exceeded
                - service_incident
                - service_maintenance
                - onboarding_incomplete
                - access_suspended
                - corridor_not_enabled
                - unsupported_pair
                - invalid_wallet_address
                - rate_unavailable
                - quote_expired
                - quote_used
                - limit_exceeded
                - amount_below_minimum
                - unsupported_asset
                - unsupported_network
                - unsupported_media_type
                - payload_too_large
                - client_ref_used
                - beneficiary_required
                - beneficiary_not_allowed
                - proof_not_expected
                - invalid_beneficiary
                - beneficiary_exists
                - beneficiary_not_active
                - invoice_required
                - prohibited_industry
              description: >-
                Stable identifier a client may branch on — never renamed or
                removed.
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
    VirtualAccount:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: >-
            The virtual account id — what a collection’s
            `source.virtual_account_id` names.
        asset:
          type: string
          minLength: 1
          description: >-
            An asset code as `GET /v2/assets` lists it — uppercase, never
            compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
            live on the payment object.
          example: USDC
        type:
          type: string
          enum:
            - bank
          description: Always `bank`.
        institution:
          type:
            - string
            - 'null'
          description: The bank that holds the account. Null while `status` is `pending`.
          example: Example Bank
        account_number:
          type:
            - string
            - 'null'
          description: >-
            The account number a payer sends to. Null while `pending`. Bank
            pay-ins carry no payer identity: a collection tells you the money
            landed here, not who sent it.
          example: '0123456789'
        account_name:
          type:
            - string
            - 'null'
          example: Acme Remittances Ltd
        status:
          type: string
          enum:
            - active
            - pending
          description: >-
            `active` — publish the coordinates. `pending` — the account is being
            issued; coordinates are null and appear without a new request.
        rail:
          type: string
          enum:
            - ach
            - fedwire
            - swift
          description: >-
            The payment rail this account receives on. There is one account for
            each rail.
          example: fedwire
        routing_number:
          type:
            - string
            - 'null'
          description: The ABA routing number for ACH and Fedwire.
          example: '021000021'
        bank_address:
          type:
            - string
            - 'null'
          description: The address of the bank, where the bank gives one.
        bank_code:
          type:
            - string
            - 'null'
          description: The SWIFT/BIC code of the bank.
          example: PORGUS62XXX
      required:
        - id
        - asset
        - type
        - institution
        - account_number
        - account_name
        - status
        - rail
        - routing_number
        - bank_address
        - bank_code
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: 'Your Jenzy API key: `Authorization: Bearer jz_live_…`'

````

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