API Profil vérifié

Comment ça marche

• Le candidat vous donne son code de partage (ex. VP-7K3F-9Q2M-XP), depuis son CV, son certificat ou son lien. Le code vaut consentement : vous ne pouvez lire que les profils dont le titulaire vous a donné le code, tant que son lien est actif.
• Chaque consultation apparaît dans le journal d’accès du candidat sous le nom de votre organisation.
• Les numéros d’identité, dates de naissance, adresses et coordonnées ne sont jamais renvoyés.

Authentification

Envoyez votre clé API dans l’en-tête X-API-Key. Les clés sont délivrées par Stodacom aux comptes clients -- contactez-nous pour en obtenir une. Gardez-la secrète et côté serveur ; ne la mettez jamais dans un navigateur ou une application mobile.

Consulter un profil

GET https://stodacomdesktop.com/api/v1/verified_profile?code=VP-XXXX-XXXX-XX

Paramètre	Description
code	Obligatoire. Le code de partage. Majuscules, espaces et tirets n’ont pas d’importance.
include_photo	Facultatif, 1 pour inclure la photo vérifiée en JPEG base64 (seulement si l’identité est partagée et la photo vérifiée).

curl -H "X-API-Key: YOUR_KEY" \
  "https://stodacomdesktop.com/api/v1/verified_profile?code=VP-7K3F-9Q2M-XP"

Réponse :

{
  "success": true,
  "profile": {
    "name": "Jane Achieng",
    "name_verified": true,
    "photo_verified": true,
    "overall_status": "partially_verified",
    "verified_count": 2,
    "total_count": 3,
    "share_code": "VP-7K3F-9Q2M-XP",
    "link_expires_at": "2026-10-27T13:10:49+03:00",
    "checked_at": "2026-09-27T13:10:49+03:00",
    "check_url": "https://stodacomdesktop.com/verified_profile_check?code=VP-7K3F-9Q2M-XP",
    "items": [
      {
        "type": "identity",
        "label": "Identity",
        "status": "verified",
        "details": [{"label": "Name on ID", "value": "Jane Achieng"}],
        "verification": {
          "method": "National ID Database Check",
          "verified_at": "2026-09-13T16:33:18+03:00",
          "valid_until": "2027-09-13T16:33:18+03:00",
          "audit_id": "STV-000144"
        }
      }
    ]
  }
}

Statuts

status de l’élément	Signification
verified	Vérifié par Stodacom et dans sa période de validité.
needs_review	Était vérifié, mais doit être ou est en cours de revérification.
discrepancy	Nos contrôles ont trouvé quelque chose qui ne correspond pas. Ne vous y fiez pas.
rejected	Examiné et n’a pas pu être vérifié.
not_verified	Jamais vérifié, ou la vérification a expiré.

overall_status vaut fully_verified, partially_verified, in_progress, issue (une divergence) ou pending.

Consulter une entreprise

Une entreprise avec laquelle vous travaillez vous donne son code de partage (ex. VB-7K3F-9Q2M-XP), depuis sa page de lien ou son certificat. Comme pour les profils, le code vaut consentement, chaque consultation apparaît dans son journal sous le nom de votre organisation, et les consultations sont comptées et facturées de la même façon. Les documents, numéros d’identité, dates de naissance et coordonnées des personnes ne sont jamais renvoyés.

GET https://stodacomdesktop.com/api/v1/verified_business?code=VB-XXXX-XXXX-XX

curl -H "X-API-Key: YOUR_KEY" \
  "https://stodacomdesktop.com/api/v1/verified_business?code=VB-7K3F-9Q2M-XP"

Réponse :

{
  "success": true,
  "business": {
    "legal_name": "Kigali Fresh Produce Ltd",
    "trading_name": "KFP",
    "registration_number": "108766432",
    "country": "Rwanda",
    "legal_form": "Limited Liability Company",
    "incorporation_date": "2019-03-04",
    "registry_status": "Active / registered",
    "trust_level": "verified",
    "items": [
      {
        "item": "registration",
        "label": "Registration",
        "status": "verified",
        "verified_on": "2026-10-25",
        "valid_until": "2027-10-25",
        "audit_id": "STB-000104",
        "change_under_review_since": null
      }
    ],
    "directors": [{"name": "Aline Uwase", "role": "Managing director"}],
    "owners": [{"name": "Aline Uwase", "type": "individual", "effective_percent": 60,
                "held": "direct", "owners_not_traced": null}],
    "address": {"registered": "KG 11 Ave, Kigali", "trading": null},
    "licences": [],
    "screening": {"last_screened_on": "2026-10-26", "confirmed_matches": []},
    "share_code": "VB-7K3F-9Q2M-XP",
    "link_expires_at": "2027-01-23",
    "checked_at": "2026-10-26T09:00:00+03:00"
  }
}

Champ	Signification
trust_level	unverified (rien de vérifié pour l’instant), registered (immatriculation vérifiée), verified (ainsi que représentant, dirigeants et propriétaires) ou verified_plus (ainsi qu’adresse et licences).
items[].status	verified, expired (ses 12 mois sont écoulés) ou not_verified.
change_under_review_since	L’entreprise a signalé un changement à cette date et il est en cours de vérification ; la vérification affichée reste valable d’ici là.
owners	Les sociétés propriétaires et les personnes détenant en fait 10 % ou plus, à travers les sociétés intermédiaires. owners_not_traced indique pourquoi les propriétaires d’une société n’ont pas été remontés (par exemple, cotée en bourse).
screening	L’entreprise, ses dirigeants et ses propriétaires sont contrôlés chaque jour par rapport aux listes de sanctions, d’exclusion et de personnes politiquement exposées. confirmed_matches liste les correspondances confirmées par notre équipe, avec leurs indicateurs.

Erreurs et limites

HTTP	Quand
400	Aucun code fourni.
401	Clé API manquante, invalide ou désactivée.
404	Aucun profil ni entreprise actif pour ce code -- mal saisi, expiré ou révoqué. À traiter comme non vérifié.
402	Vos consultations gratuites du mois sont épuisées et votre portefeuille prépayé ne couvre pas la suivante. Rechargez pour continuer.
429	Limite de débit : le quota par minute de votre clé (120 par défaut) ou 120 par minute par adresse IP.

Tarifs : les 100 premières consultations réussies de chaque mois sont gratuites, puis $0.25 l’unité -- prélevé sur votre portefeuille, ou sur votre relevé mensuel pour les comptes facturés. Les consultations qui renvoient 404 ne sont pas comptées.

Les résultats reflètent l’instant de la demande ; conservez checked_at avec ce que vous enregistrez, et refaites la consultation avant de vous fier à un ancien résultat.