# Lire une conversion

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

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

Une conversion, et le taux qu’elle a pris.

## Ce qu'on reçoit

`200` · un objet `conversion`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « conversion » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « cnv_ », par exemple cnv_01j9x3kq7m4tzv8qhw2n. |
| `from_currency` | texte | — | La monnaie vendue. |
| `to_currency` | texte | — | La monnaie reçue. |
| `amount` | entier | — | Ce qui a quitté le portefeuille de départ. |
| `amount_received` | entier | — | Ce qui est arrivé dans l’autre portefeuille. |
| `rate` | number | — | Le taux appliqué : combien d’unités reçues pour une vendue. |
| `fee` | entier | — | Les frais de change, dans la monnaie vendue. |
| `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/conversions/cnv_01j9xk5tm2p7rdb4wq8c \
  -H "Authorization: Bearer sk_test_…"
```

## La réponse

```json
{
  "object": "conversion",
  "id": "cnv_01j9xk5tm2p7rdb4wq8c",
  "from_currency": "XOF",
  "to_currency": "GHS",
  "amount": 100000,
  "amount_received": 2471,
  "rate": 0.02471,
  "fee": 500,
  "created": 1790009892,
  "livemode": false
}
```