---
title: "List virtual accounts"
method: GET
path: "/virtual_accounts"
tags: ["Virtual Accounts"]
deprecated: true
---

# List virtual accounts

`GET /virtual_accounts`

> **Deprecated.**

List and filter virtual accounts.

## Query parameters

- `limit` integer
- `starting_after` string, uuid
- `sort_order` 'asc' | 'desc'
- `start_date` string, date
- `end_date` string, date
- `name` string
- `virtual_account_number` string
- `connected_account_id` string, uuid
- `counterparty_id` string, uuid
- `disabled` boolean

## Response `200`

200

- VirtualAccountsSearchResult
  - `records` VirtualAccountsVirtualAccount[], required
    - `id` string, uuid, required — The UUID of the virtual account.
    - `object` 'virtual_account', required — The object, here `virtual_account`.
    - `name` string, required — The name of the virtual account.
    - `virtual_account_number` string, required — The virtual account number.
    - `connected_account_id` string, uuid, required — The ID of the connected account to which the virtual account refers.
    - `counterparty_id` string, uuid, nullable, required — The ID of the counterparty to which the virtual account refers to.
    - `metadata` object, required — Additional client data in JSON format. See [Metadata](https://docs.numeral.io/reference/metadata).
    - `disabled_at` string, date-time, required — The UTC timestamp of the disabling of this virtual account.
    - `created_at` string, date-time, required — The UTC timestamp of the creation of this virtual account.

## Other responses

- `400` — Validation error.

---

[API](https://skmtc.net/numeral/apis/payments.md) · [All operations](https://skmtc.net/numeral/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral/payments/revisions/220f101cc2ef/schema)