Beneficial Owners

This section is still in the beta version.

Obtaining beneficial owners from the RCBE

POST https://www.pepdata.com/api/get_beneficial_owners

Headers

Name	Type	Description
Authorization*	string	key [API_KEY]

Request Body

Name	Type	Description
vatin	string	Vat number of the organization to treat
rcbe_code	string	RCBE code

200: OK Successfull request

{
    "data": {
        "items": [
            {
		"name": "name of the person",
		"birth_date": "DD/MM/YYYY",
		"nationality": "Country_1; Country_2;",
		"is_minor": "No",
		"is_accompanied": "No",
		"has_property_or_control": "Yes/No",
		"asset_types": "Shares or Quotas/Other participation rights",
		"capital_percentage": "X %",
		"ownership_type",
		"ownership_structure",
		"has_voting_rights": "Yes/No",
		"exerts_control",
		"is_top_manager",
		"is_founder": "Yes/No",
		"is_administrator": "Yes/No",
		"is_beneficiary",
		"has_control": "Yes/No",
		"is_curator": "Yes/No",
		"has_founder_admin_curator_category"
	    }
        ]
    },
    "version": "0.1",
    "timestamp": 1646390980644
}

400: Bad Request Invalid vat number

400: Bad Request Invalid RCBE code

400: Bad Request Expired RCBE code

Attention: Unfortunately, the RCBE does not display structured information on all properties. Therefore, the properties described above without value should be interpreted as free text.

Comparison of beneficial owners with the RCBE

POST https://www.pepdata.com/api/get_beneficial_owners_divergences

Endpoint for comparison between the beneficial owners of your system and the RCBE portal.

Headers

Name	Type	Description
Authorization*	string	key [API_KEY]

Request Body

Name	Type	Description
vatin*	string	Vat number of the organization to compare
beneficial_owners*	array	Each element must contain the following format: { "id": "Person identifier", "name": "Person's full name", "birth_date": "DD/MM/YYYY", "capital_percentage": (Optional) capital value, in %. Example: 91,725 }

200: OK

{
    "data": {
        id_0: {
            status: 'found',
            matches: [rcbe_person_0],
            divergences
        },
        id_1: {
            status: 'ambiguous',
            matches: [rcbe_person_1, rcbe_person_2],
            divergences
        },
        id_2: {
            status: 'ambiguous',
            matches: [rcbe_person_3],  //same as id_iberinform_3 match
            divergences
        },
        id_3: {
            status: 'ambiguous',
            matches: [rcbe_person_3],  //same as id_iberinform_2 match
            divergences
        },
        id_4: {
            status: 'not_found',
            matches: [],
            divergences
        },
        '': {
            status: 'not_found',
            matches: [rcbe_person_4, rcbe_person_5],
            divergences
        }
    },
    "version": "0.1",
    "timestamp": 1588599744111
}

// Relevant objects
// rcbe_person: {
//    name: name_rcbe,
//    birth_date: birth_date_rcbe,
//    shares_percentage: shares_percentage_rcbe,
// }
//
// divergences: {
//    name: boolean,
//    birth_date: boolean,
//    shares_percentage: boolean,
// }

Label

• id: identifier of the person to be analyzed. This can have any value of the user's choice, there being only the obligation to be unique among the beneficial_owners to be compared. It can be empty in order to aggregate all people in the RCBE without matching the beneficial_owners to be compared.

• status:

  • found: found a unique match in the RCBE

  • ambiguous: ambiguous matches found in RCBE

  • not_found: no matches found in RCBE

• matches: list of people present in the RCBE who have corresponded with the person.

• rcbe_person: person present in the RCBE. See Relevant Objects in the response.

• divergences: object of divergences. See Relevant Objects in the response.