> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pro.resocom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lots d'analyses

> Déposez jusqu'à 200 documents, recevez tous les résultats sous 24 heures.

Pour les volumes sans contrainte de temps réel — contrôle périodique d'un
stock de dossiers, reprise d'archives lors d'une migration — le lot évite de
consommer votre débit temps réel : vous déposez, vous clôturez, tout est
analysé **sous 24 heures** (la plupart des lots finissent bien avant).

## Le cycle en trois gestes

**1. Créer le lot** — avec, si vous le souhaitez, une adresse de notification
de fin :

```bash theme={null}
curl -X POST https://pro.resocom.com/api/v1/batches \
  -H "Authorization: Bearer rsk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"externalRef": "CAMPAGNE-2026-T3", "webhookUrl": "https://votre-si.example/webhooks/resocom"}'
```

**2. Déposer les documents** un par un (200 maximum par lot) — le dépôt est
immédiat, rien n'est analysé à ce moment ; le fichier attend chiffré puis est
supprimé après traitement :

```bash theme={null}
curl -X POST https://pro.resocom.com/api/v1/batches/BAT-…/documents \
  -H "Authorization: Bearer rsk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"documentCategory": "identite", "document": "<base64>", "externalRef": "DOSSIER-001"}'
```

**3. Clôturer** — la fenêtre de complétion démarre (`expiresAt`) :

```bash theme={null}
curl -X POST https://pro.resocom.com/api/v1/batches/BAT-…/submit \
  -H "Authorization: Bearer rsk_live_…"
```

## Suivre et relire

`GET /api/v1/batches/{id}` rend le statut, les compteurs et le détail
document par document. Chaque document `succeeded` porte un
`consultationId` : le résultat complet se relit sur
`GET /api/v1/consultations/{id}` — même format que partout ailleurs.

À la fin du lot, si vous avez fourni une `webhookUrl`, l'événement
`batch.completed` vous est notifié — signé comme tous les
[événements](/webhooks/evenements).

## États d'un document

| Statut                   | Sens                                                |
| ------------------------ | --------------------------------------------------- |
| `pending` / `processing` | En attente, ou en cours d'analyse                   |
| `succeeded`              | Analysé — **seul état compté** comme acte           |
| `errored`                | Échec propre au document (`error` en donne le code) |
| `canceled`               | Lot annulé avant son passage                        |
| `expired`                | Fenêtre de 24 h atteinte avant son passage          |

Un document en erreur, annulé ou expiré **n'est jamais compté**.

## Annuler

`POST /api/v1/batches/{id}/cancel` arrête le lot : les documents non traités
passent `canceled`, les analyses déjà rendues restent acquises et
relisibles.