# List all Virtual Accounts

Returns the customer's virtual accounts, sorted by creation date (newest first), using the customer's JWT token for access.

Endpoint: GET /virtual-accounts
Version: 1.0.0
Security: JWT

## Query parameters:

  - `currency` (string)
    Filter virtual accounts by currency
    Example: "USD"

  - `before` (string)
    ISO-8601 timestamp in UTC to filter resources created before this time. Use this to avoid Page drift issue. See Pagination parameters for more details.
    Example: "2025-02-18T12:03:44Z"

  - `after` (string)
    ISO-8601 timestamp in UTC to filter resources created after this time. Use this to avoid Page drift issue. See Pagination parameters for more details.
    Example: "2025-01-18T12:03:44Z"

  - `per_page` (integer)
    Number of resources per page. Should be between 1 and 100.

  - `page` (integer)
    Page number for pagination. Starts from 1. Get the next page number from the next field in the response.

## Response 200 fields (application/json):

  - `data` (array)

  - `data.account_id` (string)
    The unique identifier for the virtual account.
    Example: "VA1001"

  - `data.currency` (string)
    The currency of the virtual account in ISO 4217 format.
    Example: "USD"

  - `data.account_number` (string)
    The unique account number for the virtual account, formatted according to the country's banking standards.
    Example: "AE88001234567890"

  - `data.name` (string)
    The name associated with the virtual account, typically the business name.
    Example: "Acme Exports"

  - `data.status` (string)
    The current status of the virtual account.
    Enum: "active", "inactive", "disabled"

  - `data.created_at` (string)
    The date and time when the virtual account was created.
    Example: "2025-08-19T07:00:00Z"

  - `data.updated_at` (string)
    The date and time when the virtual account was last updated.
    Example: "2025-08-19T07:00:00Z"

  - `page_meta` (object)

  - `page_meta.current` (integer)
    The current page number.
    Example: 2

  - `page_meta.previous` (integer,null)
    The previous page number.
    Example: 1

  - `page_meta.next` (integer,null)
    The next page number.
    Example: 3

  - `page_meta.per_page` (integer)
    The number of items per page.
    Example: 20

  - `page_meta.pages` (integer)
    The total number of pages.
    Example: 10

  - `page_meta.count` (integer)
    The total number of items.
    Example: 200

## Response 400 fields (application/json):

  - `error` (string)
    Enum: "Bad Request"

  - `message` (string)
    Error message indicating which parameter was invalid
    Example: "Missing Required parameters"

## Response 401 fields (application/json):

  - `error` (string)
    Enum: "Unauthorized"

  - `message` (string)
    Authentication credentials were missing or invalid
    Example: "Auth token expired or invalid"