---
title: "List Virtual Reference Numbers"
method: GET
path: "/virtual_reference_numbers"
tags: ["Virtual Reference Numbers"]
---

# List Virtual Reference Numbers

`GET /virtual_reference_numbers`

Retrieves a list of Virtual Reference Numbers (VRNs) associated with the specified Synthetic Account. Supports filtering by status and other attributes.

## Query parameters

- `instant_payment_rail_registration_status` 'failed' | 'pending' | 'registered' | 'unregistered' — Registration status with Newline and Fifth Third, for RTP network acceptance.
- `status` 'active' | 'archived' — A value indicating the overall state of this VRN.
- `synthetic_account_uid` string — A unique id referring to the mapped, general Synthetic Account.
- `virtual_reference_number` string — The VRN

## Other responses

- `422` — Failed to retrieve Virtual Reference Numbers

## Changes

- **2026-08-21** `54f4fe726d8f` — 1 breaking, 3 info
  - the `allOf[subschema #2]/data/items/allOf[#/components/schemas/0]/name` response's property type changed from no type to `string` for status `200`
  - added `#/components/schemas/0` to the `allOf[subschema #2]/data/items/` response property `allOf` list for the response status `200`
  - added `#/components/schemas/0` to the `allOf[subschema #2]/data/items/allOf[#/components/schemas/0]/external_uid` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/0` from the `allOf[subschema #2]/data/items/` response property `allOf` list for the response status `200`

[Change history](https://skmtc.dev/newline53/apis/newline-platform-api/changes/virtual_reference_numbers/get.md)

---

[API](https://skmtc.dev/newline53/apis/newline-platform-api.md) · [All operations](https://skmtc.dev/newline53/apis/newline-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newline53/newline-platform-api/revisions/54f4fe726d8f/schema)