---
title: "Archive a customer"
method: DELETE
path: "/api/v1/customers/{id_or_alias}"
tags: ["Customers"]
---

# Archive a customer

`DELETE /api/v1/customers/{id_or_alias}`

No linked entity will be deleted. You need to terminate all active subscriptions before archiving a customer, or the call will fail.

## Path parameters

- `id_or_alias` string, required

## Response `204`

No Content

## Other responses

- `401` — Unauthorized
- `404` — Customer not found
- `429` — Too many requests
- `500` — Internal error

## Changes

> 54 revisions in range; 50 could not be searched.

- **2025-07-09** (v1) `dece17f86f99` — 4 breaking, 7 info
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `404`
  - removed the media type `application/json` for the response with the status `500`
  - removed the success response with the status `204`
  - …7 more

[Change history](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/customers/:id_or_alias/delete.md)

---

[API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.dev/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/03f9d8ae5c5e/schema)