# Lire un bénéficiaire

`GET https://api.payiz.app/v1/recipients/{id}`

Demande une clé secrète qui porte le geste « Retraits · lire ».

Un bénéficiaire, et quand il devient utilisable.

## Ce qu'on reçoit

`200` · un objet `recipient`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « recipient » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « ben_ », par exemple ben_01j9x3kq7m4tzv8qhw2n. |
| `name` | texte | — | Le nom du bénéficiaire, tel qu’il a été enregistré. |
| `phone` | texte | — | Masqué : un numéro ne sort jamais en clair. |
| `operator` | texte | — | Le code de l’opérateur dans son pays, par exemple « mtn ». |
| `country` | texte | — | Le code ISO 3166-1 alpha-3. |
| `default` | vrai ou faux | — | Le bénéficiaire proposé d’office pour un retrait. |
| `usable_at` | entier ou null | — | Un bénéficiaire neuf attend sa carence avant le premier retrait. |
| `created` | entier ou null | — | Des secondes depuis 1970, ou null. |
| `livemode` | vrai ou faux | — | Faux en mode test : aucun argent ne circule. |

## La demande

```bash
curl https://api.payiz.app/v1/recipients/ben_01j9xd7mk4s2pvb8ya3c \
  -H "Authorization: Bearer sk_test_…"
```

## La réponse

```json
{
  "object": "recipient",
  "id": "ben_01j9xd7mk4s2pvb8ya3c",
  "name": "Adjoa Mensah",
  "phone": "+229 01 •• •• 34 00",
  "operator": "mtn",
  "country": "BEN",
  "default": true,
  "usable_at": 1789912892,
  "created": 1789826492,
  "livemode": false
}
```