Sign in
Esims

Remove a physical eSIM (owner-facing, both sources)

Removes a physical eSIM. Idempotent — returns 204 for a fresh removal or a replay of an already-removed eSIM. An eSIM currently installed on a device is uninstalled first, then removed. An eSIM in an intermediate install state returns 409 operator_resolution_required and requires manual resolution. Returns 404 if the eSIM doesn't exist or isn't owned by the caller.

delete/numbers/esims/{id}

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

Response

eSIM retired (fresh retire, or an idempotent replay of an already-retired row)

Changes