Récupérer une session par external_id
GET /v1/sessions/external/{external_id} · clé secrète sk_…
La même réponse que GET /v1/sessions/{id}, retrouvée avec votre identifiant de la requête plutôt qu'avec le nôtre. Utile si vous n'avez pas gardé l'id ses_…, par exemple après une coupure entre la création et votre enregistrement.
Paramètres du chemin
external_id string obligatoire
L'external_id transmis à la création de la session.
Réponse : l'objet session
id string
Identifiant de la session (ses_…).
object string
Toujours verification_session. (défaut : verification_session)
livemode boolean
true en production, false en mode test.
status string
État de la session (voir Sessions et états).
external_id string
Votre identifiant de la requête, tel que transmis à la création.
metadata object
Vos métadonnées, telles que transmises à la création.
allowed_document_types array<string> | null
Pièces acceptées pour cette session. Valeurs : id_card, passport.
locale string
Langue du parcours.
return_url string | null
Adresse de retour en fin de parcours.
callback_url string | null
Adresse qui reçoit le statut final, telle que transmise à la création.
price integer
Prix de la session en francs CFA (entier), réservé puis débité sur votre wallet. 0 en mode test et pour une vérification offerte.
currency string
Toujours XOF. (défaut : XOF)
created_at date
Date de création (ISO 8601, UTC).
expires_at date
Date d'expiration si l'usager ne poursuit pas le parcours. Repoussée à chaque action de l'usager.
completed_at date | null
Date de la décision (verified, rejected ou manual_review).
canceled_at date | null
Date d'annulation.
expired_at date | null
Date d'expiration effective.
document_feedback array<string> | null
Consignes en cours quand l'usager doit reprendre les photos de sa pièce (pièce floue, illisible…).
document objet | null
Pièce analysée : type (id_card, passport), country (code ISO à 2 lettres) et data, les données lues (surname, given_names, sex, birth_date, birth_place, document_number, personal_number, expiry_date, nationality). null avant l'analyse.
decision objet | null
Résultat : score (similarité du visage, de 0 à 1) et reasons, les motifs (voir les motifs). null avant la décision.
Erreurs
| 404 | not_found | Aucune session avec cet external_id pour ce compte et ce mode. |
| 401 | missing_api_key | En-tête Authorization absent. |
| 401 | invalid_api_key | Clé inconnue, révoquée, ou clé publique utilisée à la place de la clé secrète. |
| 403 | account_suspended | Compte suspendu : contactez CheckID. |
| 429 | rate_limited | Trop de requêtes pour cette clé ; réessayez après le délai de l'en-tête Retry-After. |
Format commun : voir Erreurs.
