---
title: "Archive a single Virtual Reference Number"
method: DELETE
path: "/virtual_reference_numbers/{uid}"
tags: ["Virtual Reference Numbers"]
---

# Archive a single Virtual Reference Number

`DELETE /virtual_reference_numbers/{uid}`

Archives a Virtual Reference Number, removing it from active use. Archived VRNs cannot be used for incoming payments or reconciliation.

## Response `204`

Virtual Reference Number is archived successfully

- Schema — unresolved $ref

## Other responses

- `404` — The Virtual Reference Number is not found

## Changes

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

[Change history](https://skmtc.dev/newline53/apis/newline-platform-api/changes/virtual_reference_numbers/:uid/delete.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)