# Obtenir une eSIM

> Renvoie le statut d'une eSIM que vous avez commandée, son palier et sa consommation de données mobiles ce mois-ci. Les webhooks partner.esim.ready et…

`GET /v2/api/partner/esims/{id}`

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

Renvoie le statut d'une eSIM que vous avez commandée, son palier et sa consommation de données mobiles ce mois-ci. Les webhooks [`partner.esim.ready`](/fr/docs/webhooks/event-catalog#partneresimready) et [`partner.esim.failed`](/fr/docs/webhooks/event-catalog#partneresimfailed) vous préviennent quand le statut change. Sans endpoint webhook, interrogez cet endpoint à la place, dans la [limite](/fr/docs/guides/rate-limits) de 20 requêtes de lecture par seconde et par clé.

| `status` | Signification |
|----------|---------------|
| `PROVISIONING` | L'eSIM est commandée mais pas encore prête. Cela prend en général 5 à 15 minutes. |
| `ACTIVE` | L'eSIM est prête. Les appels vers le numéro sonnent sur l'eSIM. Obtenez le [code d'activation](/fr/docs/white-label/get-esim-activation-code) pour la remettre à votre client. |
| `FAILED` | La commande n'a pas abouti. `failure_code` en donne la raison. |
| `REVOKED` | L'eSIM a été [révoquée](/fr/docs/white-label/revoke-esim), ou remplacée par une eSIM plus récente sur le même numéro. Elle ne fonctionne plus sur son téléphone, et les appels vers le numéro sonnent sur les apps Allo. |

`failure_code` vaut `null` sauf si `status` vaut `FAILED`. Vous ne pouvez consulter que les eSIM commandées sur des comptes créés par votre propre clé API. Tout autre id échoue avec `PARTNER_ESIM_NOT_FOUND`.

## Palier

- `tier` est le palier actuel de l'eSIM. Il change quand une montée de palier demandée avec [Changer le palier d'une eSIM](/fr/docs/white-label/change-esim-tier) est payée, ou quand une baisse prévue s'applique. D'ici là, c'est le palier commandé.
- `scheduled_tier` est le palier vers lequel une baisse prévue fera passer l'eSIM, et `scheduled_tier_at` la date à laquelle elle s'applique, à la fin de la période déjà payée. Les deux valent `null` quand aucune baisse n'est prévue.

## Consommation de données

`data` donne la consommation de données mobiles de l'eSIM pour le mois en cours. Il vaut `null` sauf si `status` vaut `ACTIVE`.

| Champ | Signification |
|-------|---------------|
| `used_mb` | Données mobiles utilisées ce mois-ci, en Mo. `null` tant que le réseau ne l'a pas encore remontée. |
| `allowance_mb` | Données mobiles dont l'eSIM dispose ce mois-ci, en Mo : les données du palier plus les [recharges](/fr/docs/white-label/buy-esim-topup) achetées ce mois-ci. |
| `remaining_mb` | `allowance_mb` moins `used_mb`, en Mo, jamais en dessous de 0. `null` quand `used_mb` vaut `null`. |
| `cycle_started_at` | Début du mois en cours, en UTC. |
| `cycle_ends_at` | Fin du mois en cours, en UTC. Le mois suivant commence à cette heure-là. |

- Le cycle est le mois civil, à l'heure de Paris. Les dates sont en UTC : en novembre 2026, le cycle va de `2026-10-31T23:00:00` à `2026-11-30T23:00:00`.
- Allo lit la consommation en direct sur le réseau à chaque appel. Elle peut avoir quelques minutes de retard sur l'usage réel.
- Quand l'eSIM atteint son quota, les données mobiles s'arrêtent jusqu'au mois suivant ou jusqu'à l'[achat d'une recharge](/fr/docs/white-label/buy-esim-topup). Les appels et les SMS continuent de fonctionner. La ligne n'est jamais facturée pour des données au-delà du quota.
- Allo envoie [`partner.esim.data_low`](/fr/docs/webhooks/event-catalog#partneresimdata_low) quand l'eSIM a utilisé 80 % de son quota, et [`partner.esim.data_exhausted`](/fr/docs/webhooks/event-catalog#partneresimdata_exhausted) quand elle l'a utilisé en entier. Inutile d'interroger cet endpoint pour surveiller les données.
