# Fifth Third Bancorp Virtual Reference Numbers API

**Canonical:** https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-virtual-reference-numbers-api/  
**Provider:** Fifth Third Bancorp — https://apis.io/providers/fifth-third-bancorp/  
**Base URL:** https://sandbox.newline53.com/api/v1  
**Documentation:** https://developers.newline53.com/reference/auth

Fifth Third Bancorp Virtual Reference Numbers API is one of 13 APIs that [Fifth Third Bancorp](https://apis.io/providers/fifth-third-bancorp/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Virtual Reference Numbers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

VRNs act as aliases for accounts, enabling unique use cases like accounts receivable segmentation or reconciliation. **Endpoints:** - GET [List Virtual Reference Numbers: GET /virtual_reference_numbers](https://developers.newline53.com/reference/get_virtual-reference-numbers) - POST [Create a new Virtual Reference Number: POST /virtual_reference_numbers](https://developers.newline53.com/reference/post_virtual-reference-numbers) - GET [Get a single Virtual Reference Number: GET /virtual_reference_numbers/{uid}](https://developers.newline53.com/reference/get_virtual-reference-numbers-uid) - PUT [Edit a Virtual Reference Number: PUT /virtual_reference_numbers/{uid}](https://developers.newline53.com/reference/put_virtual-reference-numbers-uid) - DELETE [Archive a Virtual Reference Number: DELETE /virtual_reference_numbers/{uid}](https://developers.newline53.com/reference/delete_virtual-reference-numbers-uid) - PUT [Lock a Virtual Reference Number: PUT /virtual_reference_numbers/{uid}/lock](https://developers.newline53.com/reference/put_virtual-reference-numbers-uid-lock) - PUT [Unlock a Virtual Reference Number: PUT /virtual_reference_numbers/{uid}/unlock](https://developers.newline53.com/reference/put_virtual-reference-numbers-uid-unlock) Virtual Reference Numbers (or VRNs) are virtualized account numbers that point to a single deposit account. They are aliases to a Synthetic Account and can form a many-to-one relationship with their parent Synthetic Account. **Common VRNs Use Cases:** - This is to reference a stored funds product that is client-managed on a separate ledger. Clients can then provide VRNs to external merchants or counterparties who wish to pay for that stored fund's product. - This provides Clients with another layer of network-addressable account numbers with which to accept payments. This many-to-one relationship affords Clients account segmentation. For instance, one VRN is utilized for Accounts Receivable (AR) while the other is used for Accounts Payable (AP), all while referencing the same underlying Account. These same VRNs can then be aligned with Custodial Accounts transactions to allow for quick reconciliation or accounting. > **Note** > For certain payment rails, like Instant Payments, VRNs must be registered with Newline and Fifth Third before being used, as this will allow for network acceptance. Please review the fields in each API reference to confirm Instant Payment registration.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/virtual_reference_numbers` | List Virtual Reference Numbers |
| POST | `/virtual_reference_numbers` | Create a new Virtual Reference Number |
| GET | `/virtual_reference_numbers/{uid}` | Get a single Virtual Reference Number |
| PUT | `/virtual_reference_numbers/{uid}` | Edit a Virtual Reference Number |
| DELETE | `/virtual_reference_numbers/{uid}` | Archive a single Virtual Reference Number |
| PUT | `/virtual_reference_numbers/{uid}/lock` | Lock a single Virtual Reference Number |
| PUT | `/virtual_reference_numbers/{uid}/unlock` | Unlock a single Virtual Reference Number |

## Machine-readable artifacts (23)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/fifth-third-bancorp/refs/heads/main/openapi/fifth-third-bancorp-virtual-reference-numbers-api-openapi.yml
- **Documentation** — https://developers.newline53.com/docs/api-authentication
- **APIReference** — https://developers.newline53.com/reference/post_auth
- **APIReference** — https://developers.newline53.com/reference/customers
- **Documentation** — https://developers.newline53.com/reference/overview-of-customer-types
- **APIReference** — https://developers.newline53.com/reference/customer-products
- **Documentation** — https://developers.newline53.com/reference/customer-product-statuses
- **APIReference** — https://developers.newline53.com/reference/products
- **APIReference** — https://developers.newline53.com/reference/pools
- **APIReference** — https://developers.newline53.com/reference/custodial-accounts
- **Documentation** — https://developers.newline53.com/reference/custodial-account-statuses
- **APIReference** — https://developers.newline53.com/reference/synthetic-accounts
- **Documentation** — https://developers.newline53.com/reference/synthetic-account-categories
- **APIReference** — https://developers.newline53.com/reference/transfers
- **Documentation** — https://developers.newline53.com/reference/transfer-statuses
- **APIReference** — https://developers.newline53.com/reference/combined-transfers
- **APIReference** — https://developers.newline53.com/reference/transactions
- **Documentation** — https://developers.newline53.com/reference/transaction-statuses-and-transaction-types
- **APIReference** — https://developers.newline53.com/reference/returns
- **APIReference** — https://developers.newline53.com/reference/virtual-reference-numbers
- **Documentation** — https://developers.newline53.com/reference/virtual-reference-number-statuses
- **APIReference** — https://developers.newline53.com/reference/sandbox
- **Documentation** — https://developers.newline53.com/docs/sandbox-walkthrough

## Other Fifth Third Bancorp APIs (12)

- [Fifth Third Bancorp Auth API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-auth-api/)
- [Fifth Third Bancorp Combined Transfers API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-combined-transfers-api/)
- [Fifth Third Bancorp Custodial Accounts API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-custodial-accounts-api/)
- [Fifth Third Bancorp Customer Products API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-customer-products-api/)
- [Fifth Third Bancorp Customers API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-customers-api/)
- [Fifth Third Bancorp Pools API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-pools-api/)
- [Fifth Third Bancorp Products API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-products-api/)
- [Fifth Third Bancorp Returns API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-returns-api/)
- [Fifth Third Bancorp Sandbox API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-sandbox-api/)
- [Fifth Third Bancorp Synthetic Accounts API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-synthetic-accounts-api/)
- [Fifth Third Bancorp Transactions API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-transactions-api/)
- [Fifth Third Bancorp Transfers API](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-transfers-api/)

## Tags

Virtual Reference Numbers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/fifth-third-bancorp/fifth-third-bancorp-virtual-reference-numbers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/fifth-third-bancorp/.