# Revoke eSIM

> Revokes an eSIM right away: it stops working on its phone for good. The number stays on the account, keeps its history and rings the Allo apps instead. The…

`POST /v2/api/partner/esims/{id}/revoke`

<Note>
**Required scope:** `PARTNER`
</Note>

Revokes an eSIM right away: it stops working on its phone for good, for example when the phone is lost or its holder leaves. The response returns the eSIM with status `REVOKED`.

## What happens to the number

- The number stays on the account, with the same owner and its call and message history.
- Calls to the number ring the Allo apps instead of the eSIM.
- The eSIM's data tier ends now and is no longer billed.
- A revoked eSIM cannot be reactivated. To put the number on a phone again, [order a new eSIM](/docs/white-label/order-esim) for it. The new order charges the setup fee.

[Remove member](/docs/white-label/remove-member) revokes the member's eSIMs for you, so you do not need to call this endpoint first.

## Idempotency

Revoking an eSIM that is already `REVOKED` returns it unchanged. An eSIM replaced by a later eSIM on the same number also reads `REVOKED`, and revoking it never touches the new one.

## Errors

| Code | What it means |
|------|---------------|
| `PARTNER_ESIM_NOT_REVOCABLE` | The eSIM is not live: it is still `PROVISIONING`, it `FAILED`, or it is being moved between the network and the eSIM (`409`). Only an `ACTIVE` eSIM can be revoked. Check it with [Get eSIM](/docs/white-label/get-esim). |
| `PARTNER_ESIM_MOVE_FAILED` | The eSIM failed to move between the network and the eSIM (`409`), so it cannot be revoked until it is checked. Contact Allo support. Nothing was changed. |
| `PARTNER_ESIM_NOT_FOUND` | No eSIM with this id was ordered on an account your API key created (`404`). |
