Skip to main content
POST
Revoke eSIM
Required scope: PARTNER
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 for it. The new order charges the setup fee.
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

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

The eSIM id returned by Order eSIM (eso-*).

Response

The revoked eSIM, with status REVOKED

data
object