Skip to main content
POST
Créer un lot

Authorizations

Authorization
string
header
required

Clé API créée dans Administration → Développeurs → Clés API (licence Groupe). Une clé en lecture seule ne peut appeler que les opérations GET.

Body

application/json
externalRef
string

Votre référence de lot.

Maximum string length: 255
webhookUrl
string

Adresse HTTPS notifiée à la fin du lot (batch.completed, signée comme les autres événements).

Response

Lot créé, ouvert au dépôt.

Lot d'analyses différées.

id
string
Example:

"BAT-1CBEA150-E475"

status
enum<string>

open : en cours de remplissage · in_progress : clôturé, en traitement · ended : terminé · canceled : annulé · expired : fenêtre dépassée.

Available options:
open,
in_progress,
ended,
canceled,
expired
externalRef
string | null

Votre référence de lot.

counts
object

Compteurs par état de document.

submittedAt
string<date-time> | null
expiresAt
string<date-time> | null

Échéance du lot : 24 h après sa création tant qu'il est ouvert, puis 24 h après sa clôture pour rendre les résultats.

endedAt
string<date-time> | null
createdAt
string<date-time>