# Lire le numéro en clair

`POST https://api.payiz.app/v1/customers/{id}/phone`

Demande une clé secrète qui porte le geste « Clients · gérer ».

Le numéro d’un client, en clair.

Un geste qui s’inscrit au journal d’audit de votre espace, au nom de la clé. La réponse ne se garde nulle part : l’en-tête Idempotency-Key n’y fait rien, et le journal des requêtes masque le numéro.

## Les en-têtes

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `Idempotency-Key` | texte | — | Sans effet ici : la réponse porte un numéro en clair, qui ne se garde nulle part. Chaque appel relit le numéro, et s’inscrit au journal. |

## Ce qu'on reçoit

`200` · un objet `customer_phone`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « customer_phone » | — | Le genre de l’objet rendu : il ne change jamais. |
| `customer` | texte | — | Le client. |
| `phone` | texte | — | Son numéro en clair, au format international. |

## La demande

```bash
curl https://api.payiz.app/v1/customers/cli_01j9xn4rt6m8wqv2hc5d/phone \
  -H "Authorization: Bearer sk_test_…" \
  -X POST
```

## La réponse

```json
{
  "object": "customer_phone",
  "customer": "cli_01j9xn4rt6m8wqv2hc5d",
  "phone": "+2290197002107"
}
```