# Révoquer une eSIM

> Révoque immédiatement une eSIM : elle cesse définitivement de fonctionner sur son téléphone, par exemple quand le téléphone est perdu ou que son titulaire…

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

<Note>
**Scope requis :** `PARTNER`
</Note>

Révoque immédiatement une eSIM : elle cesse définitivement de fonctionner sur son téléphone, par exemple quand le téléphone est perdu ou que son titulaire part. La réponse renvoie l'eSIM avec le statut `REVOKED`.

## Ce que devient le numéro

- Le numéro reste sur le compte, avec le même titulaire et son historique d'appels et de messages.
- Les appels vers le numéro sonnent sur les apps Allo au lieu de l'eSIM.
- Le palier de données de l'eSIM s'arrête tout de suite et n'est plus facturé.
- Une eSIM révoquée ne peut pas être réactivée. Pour remettre le numéro sur un téléphone, [commandez une nouvelle eSIM](/fr/docs/white-label/order-esim) pour ce numéro. La nouvelle commande facture les frais de mise en service.

[Retirer un membre](/fr/docs/white-label/remove-member) révoque les eSIM du membre pour vous : inutile d'appeler cet endpoint avant.

## Idempotence

Révoquer une eSIM déjà `REVOKED` la renvoie telle quelle. Une eSIM remplacée par une eSIM plus récente sur le même numéro est aussi `REVOKED`, et la révoquer ne touche jamais la nouvelle.

## Erreurs

| Code | Signification |
|------|---------------|
| `PARTNER_ESIM_NOT_REVOCABLE` | L'eSIM n'est pas active : elle est encore `PROVISIONING`, elle est `FAILED`, ou elle est en cours de bascule entre le réseau et l'eSIM (`409`). Seule une eSIM `ACTIVE` peut être révoquée. Vérifiez-la avec [Obtenir une eSIM](/fr/docs/white-label/get-esim). |
| `PARTNER_ESIM_MOVE_FAILED` | La bascule de l'eSIM entre le réseau et l'eSIM a échoué (`409`) : elle ne peut pas être révoquée avant d'être vérifiée. Contactez le support Allo. Rien n'a été modifié. |
| `PARTNER_ESIM_NOT_FOUND` | Aucune eSIM avec cet id n'a été commandée sur un compte créé par votre API key (`404`). |
