Cet endpoint de l'API permet de récupérer les personnes liées à une personne physique 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 |
|---|---|---|---|
|
|
integer |
La liste des personnes liées étant paginée, ce nombre représente la page que l’on souhaite récupérer. Chaque page contient 25 personnes liées |
1 |
|
|
String |
Nom technique de la source sur laquelle se trouve la personne physique |
CLIENTS |
|
|
String |
La référence de la personne physique dont on souhaite récupérer les informations |
134679852 |
Réponse synchrone
Exemple de réponse obtenue :
{
"results": [
{
"personLinkDefinitionType": "REPRESENTATIVE",
"personLinkName": "ADMINISTRATEUR",
"person": {
"externalRefId": "775670417",
"sourceName": "NGT_SOURCE_PM",
"personIntegratedData": {
"contracts": [],
"personAdditionalInformation": {},
"personMetaData": {
"entities": [],
"subEntities": []
},
"personCustomFields": [
{
"personCustomFieldDescriptorId": "67b5ffc62d446968eeb0faa4",
"value": "FRA"
},
{
"personCustomFieldDescriptorId": "67b601002d446968eeb0fab5",
"value": "GMCPRO Collectif"
},
{
"personCustomFieldDescriptorId": "67b600df2d446968eeb0fab0",
"value": "HENNER-GMC"
},
{
"personCustomFieldDescriptorId": "67b600912d446968eeb0faa7",
"value": "Groupe HENNER"
},
{
"personCustomFieldDescriptorId": "67b600a62d446968eeb0faaf",
"value": "29000.0"
}
],
"sirenCode": "775670417",
"name": "N/A",
"postalAddress": {
"address": "10 avenue des champs élysées",
"zipCode": "34000",
"country": "FRA"
},
"contract": {},
"legalEntityExtraData": {}
},
"externalApiData": {
"sirenApiData": {
"enterprise": {
"category": "GE",
"creationDate": "1971-01-01",
"denomination": "LVMH MOET HENNESSY LOUIS VUITTON",
"establishmentSirets": [
"77567041700051"
],
"legalCategory": "5800",
"legalCategoryLabel": "Société européenne à actionnaire unique",
"mainActivity": "70.10Z",
"mainActivityLabel": "Activités des sièges sociaux",
"siege": {
"address": {
"communeName": "PARIS",
"countryCode": "",
"postalCode": "75008",
"streetDescription": "MONTAIGNE",
"streetNumber": "22",
"streetType": "AVENUE"
},
"creationDate": "2002-11-25",
"mainActivity": "70.10Z",
"mainActivityLabel": "Activités des sièges sociaux",
"nic": "00051",
"person": {},
"publicationStatus": true,
"siege": true,
"siren": "775670417",
"siret": "77567041700051",
"usualDenomination": ""
},
"siren": "775670417",
"active": true,
"organizationName": "LVMH MOET HENNESSY LOUIS VUITTON",
"siegeAddress": "22 AVENUE MONTAIGNE"
}
}
},
"controlsData": {
"riskStatus": "NO_RISK_FOUND",
"lastControlDate": "2025-02-24T09:16:50.259Z",
"controlResults": [
{
"controlFamilyId": "66f543f20b4fa14dc6dae17a",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 28,
"controlTypeName": "AdverseMediaControl",
"date": "2025-02-24T09:16:12.011Z",
"computed": true,
"status": "NO_RISK_FOUND",
"description": "Contrôle AM",
"type": "BLACKLIST_PEP"
},
{
"controlFamilyId": "66f543f20b4fa14dc6dae17e",
"controlFamilyName": "Risques BODACC",
"controlTypeId": 18,
"controlTypeName": "SirenControl",
"date": "2025-02-24T09:16:50.223Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "N° SIREN : 775670417",
"controlData": "775670417",
"type": "THRESHOLD"
},
{
"controlFamilyId": "66f543f20b4fa14dc6dae17a",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 19,
"controlTypeName": "AccountFilingBodaccEventControl",
"date": "2025-02-24T09:16:50.224Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "Dépôts des comptes : 2 événements depuis un an (2)",
"controlData": "C202400975848",
"nbOfPastYearEvents": 2,
"type": "BODACC_EVENT"
},
{
"controlFamilyId": "66f543f20b4fa14dc6dae17a",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 0,
"controlTypeName": "BlacklistControl",
"date": "2025-02-24T09:16:10.432Z",
"computed": true,
"status": "NO_RISK_FOUND",
"description": "Contrôle GDA",
"type": "BLACKLIST_PEP"
}
],
"pcrId": "2025-02-24T09:16:50.259Z-KYC-1efc6ebf-a4d4-497e-a712-2150ca6cf724"
},
"active": true,
"type": "LEGAL"
},
"creationType": "API"
},
{
"personLinkDefinitionType": "REPRESENTATIVE",
"personLinkName": "ADMINISTRATEUR",
"person": {
"externalRefId": "LVMH",
"sourceName": "NGT_SOURCE_KYC",
"personIntegratedData": {
"contracts": [],
"personAdditionalInformation": {},
"personMetaData": {
"entities": [],
"subEntities": []
},
"personCustomFields": [
{
"personCustomFieldDescriptorId": "67b5ffc62d446968eeb0faa4",
"value": "FRA"
}
],
"sirenCode": "775670417",
"name": "LVMH",
"postalAddress": {},
"contract": {},
"legalEntityExtraData": {}
},
"externalApiData": {
"sirenApiData": {
"enterprise": {
"category": "GE",
"creationDate": "1971-01-01",
"denomination": "LVMH MOET HENNESSY LOUIS VUITTON",
"establishmentSirets": [
"77567041700051"
],
"legalCategory": "5800",
"legalCategoryLabel": "Société européenne à actionnaire unique",
"mainActivity": "70.10Z",
"mainActivityLabel": "Activités des sièges sociaux",
"siege": {
"address": {
"communeName": "PARIS",
"countryCode": "",
"postalCode": "75008",
"streetDescription": "MONTAIGNE",
"streetNumber": "22",
"streetType": "AVENUE"
},
"creationDate": "2002-11-25",
"mainActivity": "70.10Z",
"mainActivityLabel": "Activités des sièges sociaux",
"nic": "00051",
"person": {},
"publicationStatus": true,
"siege": true,
"siren": "775670417",
"siret": "77567041700051",
"usualDenomination": ""
},
"siren": "775670417",
"active": true,
"organizationName": "LVMH MOET HENNESSY LOUIS VUITTON",
"siegeAddress": "22 AVENUE MONTAIGNE"
}
},
"beApiData": {
"legalEntityInpiId": "63ac7478265cdaf896012955"
}
},
"controlsData": {
"riskStatus": "NO_RISK_FOUND",
"lastControlDate": "2026-01-15T09:02:28.885Z",
"controlResults": [
{
"controlFamilyId": "66f543f20b4fa14dc6dae17a",
"controlFamilyName": "Risques LCB-FT",
"controlTypeId": 0,
"controlTypeName": "BlacklistControl",
"date": "2026-01-15T09:01:54.759Z",
"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-15T09:01:01.201Z",
"computed": false,
"status": "NOT_COMPUTABLE",
"description": "Identifiant Orias : Non renseigné ou non normalisable",
"type": "ORIAS"
},
{
"controlFamilyId": "66f543f20b4fa14dc6dae17e",
"controlFamilyName": "Risques BODACC",
"controlTypeId": 18,
"controlTypeName": "SirenControl",
"date": "2025-10-02T09:40:50.044Z",
"computed": true,
"score": 0,
"status": "NO_RISK_FOUND",
"description": "N° SIREN : 775670417",
"controlData": "775670417",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c8",
"controlFamilyName": "Risque client",
"controlTypeId": 27,
"controlTypeName": "HeadcountRangeControl",
"date": "2025-10-02T09:40:50.046Z",
"computed": true,
"status": "NOT_COMPUTABLE",
"description": "Effectif : Non renseigné ou non normalisable",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c8",
"controlFamilyName": "Risque client",
"controlTypeId": 28,
"controlTypeName": "AdverseMediaControl",
"date": "2025-10-02T09:40:50.160Z",
"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": "2025-10-02T09:40:50.282Z",
"computed": true,
"status": "NOT_COMPUTABLE",
"description": "N° SIRET : Non renseigné",
"type": "THRESHOLD"
},
{
"controlFamilyId": "68187f1e015d20f8f0a2d8c3",
"controlFamilyName": "Corruption",
"controlTypeId": 1021,
"controlTypeName": "",
"date": "2025-10-02T09:40:50.291Z",
"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-15T09:02:32.062Z",
"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-15T09:02:28.885Z-KYC-bd95c044-e594-4a68-b24f-b4ef2dd31aef"
},
"active": true,
"type": "LEGAL"
},
"personInpiId": "a3d5e405-75ca-4332-9dfa-9be7a1004726",
"creationType": "API"
}
],
"nbOfResults": 2,
"pagination": {
"currentPage": 1,
"nbOfResultsPerPage": 25
},
"hasNextPage": false
}