---
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

---

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