Cet endpoint de l'API permet de récupérer les informations et résultats de contrôle d'une personne morale existante dans KYC, à partir de sa référence externe
Description
Les descriptions complètes de l’appel et de la réponse synchrone sont accessibles sur notre swagger
Méthode
GET
Paramètres d’entrée
|
Param |
Type |
Description |
Exemple |
|---|---|---|---|
|
|
String |
Nom technique de la source sur laquelle se trouve la personne morale |
CLIENTS |
|
|
String |
La référence de la personne morale dont on souhaite récupérer les informations |
134679852 |
Réponse synchrone
Exemple de réponse obtenue :
{
"person": {
"externalRefId": "API_PM_1234",
"sourceName": "NGT_SOURCE_KYC",
"personIntegratedData": {
"contracts": [
{
"type": "type",
"number": "123456",
"insurer": "insurer",
"startDate": "2024-10-23",
"endDate": "2025-10-23"
}
],
"personAdditionalInformation": {
"personType": "personType",
"genderCode": "genderCode",
"birthYear": "birthYear",
"birthMonth": "birthMonth",
"birthPlace": "birthPlace",
"legalForm": "legalForm",
"iban": "truncatedIban"
},
"personMetaData": {
"entities": [
"entity"
],
"subEntities": [
"subEntity"
]
},
"personCustomFields": [
{
"personCustomFieldDescriptorId": "67b5ffc62d446968eeb0faa4",
"value": "FRA"
}
],
"sirenCode": "348567504",
"name": "COMPANY_ABCD_1234",
"creationDate": "2019-10-23",
"oriasId": "12345678",
"naf": "B06_10Z",
"postalAddress": {
"address": "1 rue du test",
"zipCode": "40500",
"city": "COUDURES",
"country": "FRA",
"building": "Appartement 01"
},
"registrationDate": "2020-11-24",
"issuingOffice": "issuingOffice",
"contract": {
"startDate": "2025-03-01T10:00:00Z",
"endDate": "2026-03-01T10:00:00Z"
},
"siret": "12345678901234",
"legalCategory": "legalCategory",
"personType": "personType",
"headcount": 11,
"headcountRange": "R010_049",
"legalEntityExtraData": {
"occupation": "occupation"
}
},
"externalApiData": {
"sirenApiData": {
"enterprise": {
"category": "ETI",
"creationDate": "1988-10-04",
"denomination": "PORSCHE FRANCE",
"establishmentSirets": [
"34856750400066",
"34856750400074",
"34856750400082"
],
"legalCategory": "5710",
"legalCategoryLabel": "Société pluri-professionnelle d'exercice par actions simplifiée",
"mainActivity": "45.11Z",
"mainActivityLabel": "Commerce de voitures et de véhicules automobiles légers",
"siege": {
"address": {
"communeName": "ASNIERES-SUR-SEINE",
"countryCode": "",
"postalCode": "92600",
"streetDescription": "AULAGNIER",
"streetNumber": "25",
"streetType": "QUAI"
},
"creationDate": "2018-04-10",
"mainActivity": "45.11Z",
"mainActivityLabel": "Commerce de voitures et de véhicules automobiles légers",
"nic": "00074",
"person": {},
"publicationStatus": true,
"siege": true,
"siren": "348567504",
"siret": "34856750400074",
"usualDenomination": ""
},
"siren": "348567504",
"active": true,
"organizationName": "PORSCHE FRANCE",
"siegeAddress": "25 QUAI AULAGNIER"
}
}
},
"controlsData": {
"riskStatus": "NO_RISK_FOUND",
"lastControlDate": "2026-01-21T14:25:55.695Z",
"controlResults": [
{
"controlFamilyId": "66f543f20b4fa14dc6dae17a",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 0,
"controlTypeName": "BlacklistControl",
"date": "2026-01-21T14:25:50.807Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "Contrôle GDA",
"type": "BLACKLIST_PEP"
},
{
"controlFamilyId": "66f543f20b4fa14dc6dae17a",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 12,
"controlTypeName": "OriasControl",
"date": "2026-01-21T14:25:54.321Z",
"computed": false,
"status": "NOT_COMPUTABLE",
"description": "Identifiant Orias : 12345678",
"controlData": "12345678",
"type": "ORIAS"
},
{
"controlFamilyId": "66f543f20b4fa14dc6dae17e",
"controlFamilyName": "Risques BODACC",
"controlTypeId": 18,
"controlTypeName": "SirenControl",
"date": "2026-01-21T14:25:54.324Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "N° SIREN : 348567504",
"controlData": "348567504",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c8",
"controlFamilyName": "Risque client",
"controlTypeId": 27,
"controlTypeName": "HeadcountRangeControl",
"date": "2026-01-21T14:25:54.411Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "Effectif : PME (entre 10 et 49 personnes)",
"controlData": "headcountRange.11-[fr_FR]",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c8",
"controlFamilyName": "Risque client",
"controlTypeId": 28,
"controlTypeName": "AdverseMediaControl",
"date": "2026-01-21T14:25:54.888Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "Contrôle AM",
"type": "BLACKLIST_PEP"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c8",
"controlFamilyName": "Risque client",
"controlTypeId": 60,
"controlTypeName": "SiretControl",
"date": "2026-01-21T14:25:55.132Z",
"computed": true,
"score": 100,
"status": "POTENTIAL_RISK",
"description": "N° SIRET : 12345678901234, N° SIREN : 348567504. SIRET ne correspondant pas au SIREN",
"controlData": "12345678901234",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c3",
"controlFamilyName": "Corruption",
"controlTypeId": 1021,
"controlTypeName": "",
"date": "2026-01-21T14:25:55.695Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "FRA",
"controlData": "FRA",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68baea3f41b134654a069c0a",
"controlFamilyName": "Statut de vigilance",
"controlTypeId": 56,
"controlTypeName": "VigilanceControl",
"date": "2026-01-21T14:25:55.720Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "Données et résultats de contrôle de la personne",
"vigilanceStatus": "NO_VIGILANCE_STATUS",
"type": "VIGILANCE"
}
],
"pcrId": "2026-01-21T14:25:55.695Z-KYC-06b50df0-06c7-45b2-bd70-743e69df1f1b"
},
"active": true,
"type": "LEGAL"
},
"personLinks": {
"BENEFICIAL_OWNER": 0,
"REPRESENTATIVE": 0,
"ENTREPRENEUR": 0
}
}