# Vérifications

Une **vérification** (`check`, identifiant `chk_...`) est l'analyse d'un document. Ces routes les lisent une par une, les listent, donnent leur rapport PDF et les suppriment.

## Lire une vérification

```
GET /api/v1/checks/{id}
```

| Paramètre | Description |
|---|---|
| `detail` | `minimal` (par défaut) ou `full` pour ajouter l'objet `details`. |

```bash
curl "https://france-verification.com/api/v1/checks/chk_52817?detail=full" \
  -H "Authorization: Bearer $FV_API_KEY"
```

Réponse : l'objet [Check](/developpeurs/objets).

## Lister les vérifications

```
GET /api/v1/checks
```

Avec une clé live, la liste contient **toutes** les vérifications du compte, y compris celles faites sur le site. Avec une clé test, seulement les vérifications fictives des envois de test. Tri : de la plus récente à la plus ancienne.

| Paramètre | Description |
|---|---|
| `page` | Numéro de page, à partir de 1. |
| `per_page` | De 1 à 100. Par défaut 50. |
| `detail` | `minimal` ou `full`. |

```json
{
  "data": [ { "id": "chk_52817", "status": "completed", "verdict": "SUSPECT", "...": "..." } ],
  "pagination": { "page": 1, "per_page": 50, "total": 128, "has_more": true }
}
```

Tant que `has_more` vaut `true`, demandez la page suivante.

## Télécharger le rapport PDF

```
GET /api/v1/checks/{id}/report.pdf
```

Le même rapport que sur le site, prêt à archiver ou à transmettre. Disponible quand la vérification est `completed` (le champ `report_url` de l'objet donne l'adresse exacte).

```bash
curl -o rapport.pdf https://france-verification.com/api/v1/checks/chk_52817/report.pdf \
  -H "Authorization: Bearer $FV_API_KEY"
```

| Statut | Code | Cause |
|---|---|---|
| 404 | `not_found` | Vérification inconnue, ou pas encore terminée. |
| 409 | `not_available_in_test_mode` | Les vérifications de test n'ont pas de rapport. |

## Supprimer une vérification

```
DELETE /api/v1/checks/{id}
```

Efface tout de suite le fichier envoyé, son aperçu, l'analyse et le journal technique. Réponse : `204 No Content`. La suppression est définitive.

Sans suppression de votre part, les fichiers envoyés sont effacés automatiquement au bout de 7 jours ; le résultat de l'analyse, lui, reste consultable.