---
title: "Deactivate a brand/campaign registration"
method: DELETE
path: "/v1/sms/registrations/{id}"
tags: ["SMS"]
---

# Deactivate a brand/campaign registration

`DELETE /v1/sms/registrations/{id}`

Terminates the campaign with the carrier registry so the recurring
monthly campaign fee stops (carriers bill the first 3 months of a
campaign regardless). Numbers covered by it can no longer SEND texts
(receiving is unaffected) until they're registered under a new brand.
Irreversible: a deactivated campaign cannot be restored; texting again
later requires a new registration (new one-time and review fees).
Idempotent.

## Path parameters

- `id` string, required

## Response `200`

Registration deactivated.

- object
  - `status` 'deactivated'

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Registration not found

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/sms/registrations/:id/delete.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/dd3865482f9f?raw)