Les listes de sanctions et de PPE, prêtes à intégrer par API

Comment ça marche

Ce que vous obtenez

Authenica fournit des données de conformité prêtes à l'emploi : le criblage de vos clients contre des listes publiques et officielles de sanctions et de personnes politiquement exposées (PPE), consolidées, rechargées régulièrement et servies par une API sécurisée, pour que vos équipes n'aient ni à collecter ni à normaliser ces listes elles-mêmes.

Les listes interrogées

Le criblage porte sur des listes publiques et officielles, publiées par leurs émetteurs et rechargées régulièrement. De nouvelles sources s'ajoutent au fil du temps ; la liste à jour est toujours disponible par l'API (voir « Lister les sources »).

Démarrer en deux minutes

1. Obtenez une cléÉcrivez-nous : nous créons votre accès et vous remettons la clé.
2. Appelez l'APIUn appel POST avec le nom cherché et votre clé.
3. Lisez le résultatUne liste de fiches, chacune avec sa liste et sa version.

curl -X POST https://api.authenica.tech/api/v1/screenings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Zorbek Nandrawell","scoreThreshold":0.85}'

Obtenir votre clé

1. Écrivez à it@authenica.tech avec le nom de votre organisation et l'usage prévu.
2. Nous créons votre accès et vous remettons la clé une seule fois. Elle n'est pas conservée en clair : nous ne pouvons pas vous la redonner, seulement en créer une nouvelle.
3. Nous convenons avec vous d'un quota par minute.

Pour changer ou révoquer une clé, écrivez à la même adresse. La révocation est immédiate.

Authentification

Chaque appel porte votre clé dans l'en-tête X-Api-Key. L'adresse de base est https://api.authenica.tech, en HTTPS seulement : un appel en HTTP est redirigé.

Sans clé, avec une clé inconnue ou révoquée : réponse 401. Connaître l'adresse ne donne aucun accès.

Interroger les listes

POST /api/v1/screenings

Ce que vous envoyez

Lire la réponse

Réponse 200 :

{
  "requestId": "63f766c4-9c1c-4adb-ac8e-4e66674b4be0",
  "matches": [
    {
      "listType": "SANCTIONS",
      "listName": "AUTHENICA_TEST_SANCTIONS",
      "listVersion": "a0a0a0a0-0000-4000-8000-000000000001",
      "targetLabel": "Zorbek NANDRAWELL",
      "score": 1.0,
      "confidence": "UNCORROBORATED",
      "evidence": [
        {
          "field": "DOCUMENT_NUMBER",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": null
        },
        {
          "field": "DATE_OF_BIRTH",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": "15 Jun 1975"
        },
        {
          "field": "NATIONALITY",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": "Mali"
        },
        {
          "field": "PLACE_OF_BIRTH",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": "Bamako"
        }
      ],
      "details": {
        "entityType": "NATURAL_PERSON",
        "list": {
          "label": "Liste d'essai fictive : sanctions",
          "publisher": "Authenica"
        },
        "sanctionPrograms": [
          "TEST-FICTIF"
        ],
        "title": "Personne fictive de la liste d'essai",
        "description": "Fiche fictive pour tester l'intégration. Aucune personne réelle.",
        "nationalities": [
          "Mali"
        ],
        "datesOfBirth": [
          "15 Jun 1975"
        ],
        "placesOfBirth": [
          "Bamako"
        ]
      }
    }
  ],
  "ignoredFields": []
}

La confiance, en clair

Elle n'écarte jamais une fiche : un homonyme probable reste une alerte à faire examiner par une personne.

Le détail de la fiche

Le bloc details reprend ce que l'émetteur de la liste publie sur la fiche. Il aide à distinguer deux homonymes, par exemple deux personnes qui portent le même nom mais n'ont pas la même fonction.

Le détail de la comparaison

Chaque ligne de evidence a field (DATE_OF_BIRTH, NATIONALITY, PLACE_OF_BIRTH ou DOCUMENT_NUMBER), customerValue (ce que vous avez envoyé), listValue (ce que dit la fiche) et status :

• MATCH : les deux concordent.
• CONFLICT : les deux se contredisent.
• UNKNOWN : l'un des deux côtés ne renseigne pas l'élément, donc ni confirmation ni contradiction.

Essayez avec des cas de test

Authenica tient une liste d'essai fictive pour tester votre intégration de bout en bout, avec des résultats reproductibles. Elle ne contient aucune personne ni société réelle : les noms ci-dessous n'existent pas. Vous pouvez rejouer chaque requête avec votre clé et obtenir la même réponse.

curl -X POST https://api.authenica.tech/api/v1/screenings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Zorbek Nandrawell","dateOfBirth":"1975-06-15","nationality":"ML","scoreThreshold":0.85}'

{
  "requestId": "b0fa0a4d-8236-44bc-9979-2a0a41fc95f2",
  "matches": [
    {
      "listType": "SANCTIONS",
      "listName": "AUTHENICA_TEST_SANCTIONS",
      "listVersion": "a0a0a0a0-0000-4000-8000-000000000001",
      "targetLabel": "Zorbek NANDRAWELL",
      "score": 1.0,
      "confidence": "CORROBORATED",
      "evidence": [
        {
          "field": "DOCUMENT_NUMBER",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": null
        },
        {
          "field": "DATE_OF_BIRTH",
          "status": "MATCH",
          "customerValue": "1975-06-15",
          "listValue": "15 Jun 1975"
        },
        {
          "field": "NATIONALITY",
          "status": "MATCH",
          "customerValue": "ML",
          "listValue": "Mali"
        },
        {
          "field": "PLACE_OF_BIRTH",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": "Bamako"
        }
      ],
      "details": {
        "entityType": "NATURAL_PERSON",
        "list": {
          "label": "Liste d'essai fictive : sanctions",
          "publisher": "Authenica"
        },
        "sanctionPrograms": [
          "TEST-FICTIF"
        ],
        "title": "Personne fictive de la liste d'essai",
        "description": "Fiche fictive pour tester l'intégration. Aucune personne réelle.",
        "nationalities": [
          "Mali"
        ],
        "datesOfBirth": [
          "15 Jun 1975"
        ],
        "placesOfBirth": [
          "Bamako"
        ]
      }
    }
  ],
  "ignoredFields": []
}

curl -X POST https://api.authenica.tech/api/v1/screenings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Kassim Dromvale","dateOfBirth":"1968-03-02","nationality":"CI","scoreThreshold":0.85}'

{
  "requestId": "5ce9f675-92cf-4f19-9bd3-3098496f12e9",
  "matches": [
    {
      "listType": "PPE",
      "listName": "AUTHENICA_TEST_PPE",
      "listVersion": "a0a0a0a0-0000-4000-8000-000000000002",
      "targetLabel": "Kassim DROMVALE",
      "score": 1.0,
      "confidence": "CORROBORATED",
      "evidence": [
        {
          "field": "DOCUMENT_NUMBER",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": null
        },
        {
          "field": "DATE_OF_BIRTH",
          "status": "MATCH",
          "customerValue": "1968-03-02",
          "listValue": "02 Mar 1968"
        },
        {
          "field": "NATIONALITY",
          "status": "MATCH",
          "customerValue": "CI",
          "listValue": "Côte d'Ivoire"
        },
        {
          "field": "PLACE_OF_BIRTH",
          "status": "UNKNOWN",
          "customerValue": null,
          "listValue": "Abidjan"
        }
      ],
      "details": {
        "entityType": "NATURAL_PERSON",
        "list": {
          "label": "Liste d'essai fictive : personnes politiquement exposées",
          "publisher": "Authenica"
        },
        "sanctionPrograms": [],
        "title": "Ministre (fonction fictive)",
        "description": "Fiche fictive pour tester l'intégration. Aucune personne réelle.",
        "nationalities": [
          "Côte d'Ivoire"
        ],
        "datesOfBirth": [
          "02 Mar 1968"
        ],
        "placesOfBirth": [
          "Abidjan"
        ]
      }
    }
  ],
  "ignoredFields": []
}

curl -X POST https://api.authenica.tech/api/v1/screenings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Aminata Kone Diabate","dateOfBirth":"1990-04-12","nationality":"CI","scoreThreshold":0.85}'

{
  "requestId": "3b3a92ce-018f-452e-a63b-24d9129179a6",
  "matches": [],
  "ignoredFields": []
}

curl -X POST https://api.authenica.tech/api/v1/screenings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Nandrawell Holding SARL","entityType":"LEGAL_ENTITY","scoreThreshold":0.85}'

{
  "requestId": "bf7e6348-5909-49a4-a997-ed600d1e7494",
  "matches": [
    {
      "listType": "SANCTIONS",
      "listName": "AUTHENICA_TEST_SANCTIONS",
      "listVersion": "a0a0a0a0-0000-4000-8000-000000000001",
      "targetLabel": "NANDRAWELL HOLDING SARL",
      "score": 1.0,
      "confidence": "UNCORROBORATED",
      "evidence": [],
      "details": {
        "entityType": "LEGAL_ENTITY",
        "list": {
          "label": "Liste d'essai fictive : sanctions",
          "publisher": "Authenica"
        },
        "sanctionPrograms": [
          "TEST-FICTIF"
        ],
        "title": "Société fictive de la liste d'essai",
        "description": "Fiche fictive pour tester l'intégration. Aucune société réelle.",
        "nationalities": [],
        "datesOfBirth": [],
        "placesOfBirth": []
      }
    }
  ],
  "ignoredFields": []
}

Filtrer la recherche

Deux filtres, qui se combinent. Un filtre absent ne filtre rien.

# Seulement les personnes politiquement exposées
-d '{"fullName":"Kassim Dromvale","scoreThreshold":0.85,"listTypes":["PPE"]}'

# Seulement les sociétés, dans les listes de sanctions
-d '{"fullName":"Société Exemple SARL","scoreThreshold":0.85,"entityType":"LEGAL_ENTITY","listTypes":["SANCTIONS"]}'

# Avec la date de naissance et la nationalité, pour corroborer
-d '{"fullName":"Zorbek Nandrawell","scoreThreshold":0.85,"corroboratedThreshold":0.70,"dateOfBirth":"1975-06-15","nationality":"ML"}'

Un type inconnu (par exemple "entityType":"NAVIRE") est refusé avec une erreur 400.

Lister les sources

GET /api/v1/lists/sources

Une entrée par liste : code (celui que vous retrouvez dans listName), label (son nom lisible), publisher (l'émetteur), listType, lastBatchId (le dernier lot chargé, celui que vous retrouvez dans listVersion), lastLoadedAt (la date du chargement), status et entityCount (le nombre de fiches). Aucune donnée personnelle.

curl https://api.authenica.tech/api/v1/lists/sources -H "X-Api-Key: $AUTHENICA_CLE_API"

Lire et contrôler une pièce d'identité

Au-delà des listes, Authenica lit une pièce d'identité à partir de sa photo : carte d'identité, passeport, permis de conduire, titre de séjour. Le service rend les champs lus, le modèle de pièce reconnu et les contrôles menés (validité, authenticité, qualité de l'image, cohérence de la zone lisible par machine). Vous préremplissez ainsi votre formulaire d'entrée en relation et vous savez si la pièce mérite confiance.

Ce que vous envoyez

POST /api/v1/document-readings, en multipart/form-data, avec votre clé dans X-Api-Key comme pour les listes.

Images JPEG ou PNG, 5 Mo au plus chacune. Le contenu est vérifié : un fichier renommé en .jpg qui n'est pas une image est refusé.

curl -X POST https://api.authenica.tech/api/v1/document-readings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -F "front=@recto.jpg;type=image/jpeg" \
  -F "back=@verso.jpg;type=image/jpeg"

Ce que vous recevez

Les signalements

Un essai réel sur une pièce fictive

Voici la réponse réelle de l'API pour une image de passeport générée pour l'essai : elle n'est pas authentique et ne porte que des données inventées. Le service lit les champs, mais signale que le modèle n'est pas reconnu et que les contrôles d'authenticité n'ont pas pu être menés, exactement ce qu'il doit faire. Pour une pièce authentique d'un modèle connu, le modèle est nommé et les contrôles de sécurité sont menés et comptés dans securityChecks.

curl -X POST https://api.authenica.tech/api/v1/document-readings \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -F "singlePage=@passeport-fictif.png;type=image/png"

{
  "requestId": "c6f82bd1-898a-45de-bcbf-95925b156d48",
  "documentName": null,
  "fields": {
    "LAST_NAME": {
      "value": "KONE",
      "confidence": 78,
      "source": "MRZ",
      "validity": "NOT_PERFORMED",
      "consistent": true
    },
    "GIVEN_NAMES": {
      "value": "AMINATA",
      "confidence": 82,
      "source": "MRZ",
      "validity": "NOT_PERFORMED",
      "consistent": true
    },
    "DATE_OF_BIRTH": {
      "value": "1990-04-12",
      "confidence": 34,
      "source": "MRZ",
      "validity": "ERROR",
      "consistent": true
    },
    "NATIONALITY": {
      "value": "CIV",
      "confidence": 97,
      "source": "MRZ",
      "validity": "OK",
      "consistent": true
    },
    "DOCUMENT_NUMBER": {
      "value": "XXI2345G7",
      "confidence": 34,
      "source": "MRZ",
      "validity": "ERROR",
      "consistent": true
    },
    "EXPIRY_DATE": {
      "value": "2031-01-01",
      "confidence": 29,
      "source": "MRZ",
      "validity": "OK",
      "consistent": true
    }
  },
  "otherFields": {
    "MRZ Type": {
      "value": "ID-3",
      "confidence": 100,
      "source": "MRZ",
      "validity": "NOT_PERFORMED",
      "consistent": true
    },
    "Issuing State Name": {
      "value": "Cote d'Ivoire",
      "confidence": 0,
      "source": "MRZ",
      "validity": "OK",
      "consistent": true
    }
  },
  "authenticity": {
    "overall": "ERROR",
    "documentType": "ERROR",
    "security": "NOT_PERFORMED",
    "expiry": "OK",
    "imageQuality": "ERROR",
    "mrz": "ERROR",
    "securityChecks": null
  },
  "expired": false,
  "warnings": [
    "DOCUMENT_TYPE_NOT_RECOGNISED",
    "AUTHENTICITY_NOT_PERFORMED",
    "LOW_IMAGE_QUALITY",
    "MRZ_CHECK_FAILED"
  ]
}

Les erreurs

Les erreurs

Toute erreur a la même forme : {"code": "...", "message": "...", "requestId": "..."}. Le message ne reprend jamais ce que vous avez envoyé.

Exemples de code

Dans chaque exemple, la clé vient d'une variable d'environnement et l'échec suspend l'opération.

import os, requests

reponse = requests.post(
    "https://api.authenica.tech/api/v1/screenings",
    headers={"X-Api-Key": os.environ["AUTHENICA_CLE_API"]},
    json={"fullName": "Zorbek Nandrawell", "scoreThreshold": 0.85, "listTypes": ["SANCTIONS"]},
    timeout=10,
)
if reponse.status_code != 200:
    raise RuntimeError(f"Criblage impossible ({reponse.status_code}) : suspendre l'opération")
for fiche in reponse.json()["matches"]:
    print(fiche["listName"], fiche["listVersion"], fiche["score"], fiche["confidence"])

// Node.js 18 ou plus
const reponse = await fetch("https://api.authenica.tech/api/v1/screenings", {
  method: "POST",
  headers: { "X-Api-Key": process.env.AUTHENICA_CLE_API, "Content-Type": "application/json" },
  body: JSON.stringify({ fullName: "Zorbek Nandrawell", scoreThreshold: 0.85 }),
  signal: AbortSignal.timeout(10_000),
});
if (!reponse.ok) throw new Error(`Criblage impossible (${reponse.status}) : suspendre l'opération`);
const { matches, requestId } = await reponse.json();

// Java 11 ou plus
HttpRequest requete = HttpRequest.newBuilder(URI.create("https://api.authenica.tech/api/v1/screenings"))
    .timeout(Duration.ofSeconds(10))
    .header("X-Api-Key", System.getenv("AUTHENICA_CLE_API"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"fullName\":\"Zorbek Nandrawell\",\"scoreThreshold\":0.85}"))
    .build();
HttpResponse<String> reponse = HttpClient.newHttpClient().send(requete, HttpResponse.BodyHandlers.ofString());
if (reponse.statusCode() != 200) throw new IllegalStateException("Criblage impossible : suspendre l'opération");

curl -X POST https://api.authenica.tech/api/v1/screenings \
  --max-time 10 --fail-with-body \
  -H "X-Api-Key: $AUTHENICA_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"Zorbek Nandrawell","scoreThreshold":0.85}'

Contrat OpenAPI

Le contrat de l'API est publié sur https://api.authenica.tech/v3/api-docs. Vous pouvez l'importer dans Postman ou Insomnia, ou générer un client avec un outil comme OpenAPI Generator.

Bonnes pratiques

• Conservez le requestId et la listVersion avec votre décision : c'est votre preuve en cas d'inspection.
• Ne journalisez pas les noms cherchés ni la clé. Authenica ne les garde pas non plus : elle recherche, elle ne stocke pas.
• Un résultat n'est pas une décision : une personne examine chaque correspondance.
• Les listes sont rechargées automatiquement. La date du dernier chargement de chaque liste est dans la liste des sources.
• Fixez un délai d'attente à chaque appel et décidez à l'avance ce que fait votre processus si le service ne répond pas : il suspend.

Forfaits

Nous contacter

Une clé à demander, à changer ou à révoquer, une question d'intégration, un incident : it@authenica.tech. Indiquez le requestId de l'appel concerné quand vous en avez un.