Ce endpoint de l'API permet, à partir d’un SIREN ou d’une référence unique donné en entrée, d’envoyer au client des informations sur les personnes liées (identités et résultats des contrôles GDA et PPE).
Description
Les descriptions complètes de l’appel sont accessibles sur notre swagger
Méthode
GET
Paramètres
|
Nom de la donnée |
Type |
Exemple |
Obligatoire |
|---|---|---|---|
|
nom technique de la source |
Alphanumérique |
BECLM_CLIENTS |
|
|
référence externe |
Alphanumérique |
DEMO_001 |
|
|
Page demandée (pagination) |
Int |
1 |
|
Exemple d’une réponse
JSON
{
"results": [
{
"personLinkDefinitionType": "BENEFICIAL_OWNER",
"personLinkName": "Bénéficiaire",
"person": {
"externalRefId": "externalRefId",
"sourceName": "sourceName",
"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"
},
"personMetaData": {
"entities": [
"entity"
],
"subEntities": [
"subEntity"
]
},
"personCustomFields": [
{
"personCustomFieldDescriptorId": "personCustomFieldDescriptorId",
"value": "1500.58"
}
],
"sirenCode": "123456789",
"name": "Example Legal Entity",
"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",
"legalEntityRef": {
"sourceName": "sourceName",
"externalRefId": "externalRefId"
}
},
"siret": "12345678901234",
"legalCategory": "legalCategory",
"personType": "personType",
"headcount": 11,
"headcountRange": "R010_049",
"legalEntityExtraData": {
"occupation": "occupation"
}
},
"externalApiData": {
"sirenApiData": {
"enterprise": {
"acronym": "acronym",
"category": "PME",
"creationDate": "2014-04-10",
"denomination": "BE CLM",
"denominationUsuelle": "denominationUsuelle",
"establishmentSirets": [
"80231443500016",
"80231443500024"
],
"legalCategory": "5710",
"legalCategoryLabel": "Société pluri-professionnelle d'exercice par actions simplifiée",
"mainActivity": "62.01Z",
"mainActivityLabel": "Programmation informatique",
"siege": {
"address": {
"communeName": "BOULOGNE-BILLANCOURT",
"countryCode": "",
"postalCode": "92100",
"streetDescription": "PIERRE GRENIER",
"streetNumber": "67",
"streetType": "AVENUE"
},
"creationDate": "2014-04-10",
"enseigne1": "enseigne1",
"enseigne2": "enseigne2",
"enseigne3": "enseigne3",
"flag": "flag",
"mainActivity": "62.01Z",
"mainActivityLabel": "Programmation informatique",
"name": "name",
"nic": "00016",
"person": {
"commonFirstname": "commonFirstname",
"commonName": "commonName",
"firstname": "firstname",
"gender": "gender",
"lastname": "lastname",
"pseudonym": "pseudonym"
},
"publicationStatus": true,
"siege": true,
"siren": "802314435",
"siret": "80231443500016",
"usualDenomination": ""
},
"siren": "802314435",
"active": true
}
},
"oriasApiData": {
"intermediarySearchResponse": {
"intermediaries": [
{
"informationBase": {
"siren": "123456789",
"registrationNumber": "12345678",
"denomination": "denomination",
"isFoundInRegistry": true
},
"registrations": [
{
"categoryName": "COBSP",
"status": "REGISTERED",
"registrationDate": "2024-07-01T10:00:00Z",
"deletionDate": "2024-07-01T10:00:00Z",
"isCollectFunds": true,
"bankActivities": [
"CONSUMER_CREDIT",
"OTHER_ACTIVITIES"
],
"mandators": [
{
"siren": "123456789",
"denomination": "denomination",
"bankActivities": [
"CONSUMER_CREDIT",
"OTHER_ACTIVITIES"
]
}
]
}
]
}
]
}
},
"beApiData": {
"sharesOwnershipPercent": 12.5
}
},
"controlsData": {
"riskStatus": "POTENTIAL_RISK",
"lastControlDate": "2025-03-05T10:00:00Z",
"controlResults": [
{
"controlFamilyId": "66fa8d123bce49b2393135e5",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 3,
"controlTypeName": "GafiControl",
"date": "2025-03-05T10:00:00Z",
"computed": true,
"score": 100,
"status": "POTENTIAL_RISK",
"description": "Contrôle GAFI",
"controlData": "Donnée Client",
"type": "THRESHOLD"
},
{
"controlFamilyId": "66fa8d123bce49b2393135e5",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 0,
"controlTypeName": "BlacklistControl",
"date": "2025-03-05T09:50:00Z",
"computed": true,
"score": 100,
"status": "POTENTIAL_RISK",
"description": "Contrôle GDA",
"controlData": "Donnée Client",
"riskFolderId": "88fa8d123bce49b2393139f0",
"type": "BLACKLIST_PEP"
},
{
"controlFamilyId": "66fa8d123bce49b2393135e5",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 0,
"controlTypeName": "OriasControl",
"date": "2025-03-05T09:50:00Z",
"computed": true,
"score": 100,
"status": "POTENTIAL_RISK",
"description": "Contrôle Orias",
"controlData": "Données Client",
"oriasRegistration": {
"number": "12345678",
"status": "UNREGISTERED",
"dateChecked": "2025-03-05T09:50:00Z"
},
"type": "ORIAS"
},
{
"controlFamilyId": "66fa8d123bce49b2393135e5",
"controlFamilyName": "Risques Bodacc",
"controlTypeId": 0,
"controlTypeName": "CreationBodaccEventControl",
"date": "2025-03-05T09:50:00Z",
"computed": true,
"score": 100,
"status": "POTENTIAL_RISK",
"description": "Contrôle Bodacc",
"controlData": "Données Client",
"nbOfPastYearEvents": 1,
"type": "BODACC_EVENT"
}
],
"pcrId": "2025-03-05T10:00:00.000Z-KYC-cb3b5b33-6929-4caf-b27e-60fdbaa7cdef"
},
"type": "LEGAL"
}
}
],
"nbOfResults": 1,
"pagination": {
"currentPage": 1,
"nbOfResultsPerPage": 25
},
"hasNextPage": false
}