Beneficial Owners

This section is still in the beta version.

Comparison of data from the Iberinform platform with the RCBE portal

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

Headers

Name	Type	Description
Authorization*	string	key [API_KEY]

Request Body

Name	Type	Description
vatin*	string	Vat number of the organization to compare
include_rcbe_response	boolean	Instruction for incorporating the RCBE response. Format: false/true Default: false

200: OK Successfull request

{
    "data": {
        "id_iberinform_0": {
            status: 'found',
            matches: [rcbe_person_0],
            divergences
        },
        "id_iberinform_1": {
            status: 'ambiguous',
            matches: [rcbe_person_1, rcbe_person_2],
            divergences
        },
        "id_iberinform_2": {
            status: 'ambiguous',
            matches: [rcbe_person_3],  //same as id_iberinform_3 match
            divergences
        },
        "id_iberinform_3": {
            status: 'ambiguous',
            matches: [rcbe_person_3],  //same as id_iberinform_2 match
            divergences
        },
        "id_iberinform_4": {
            status: 'not_found',
            matches: [],
            divergences
        },
        "": {
            status: 'not_found',
            matches: [rcbe_person_4, rcbe_person_5],
            divergences
        },
        "rcbe_response": [
            {
		"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": 1588599744111
}

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

400: Bad Request No vat number found

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030777756,
        "message": "No VAT identification number was provided."
    }
}

Label

• id_iberinform: Iberinform system id. It can be empty in order to aggregate all the people from the Central Registry of the Beneficial Owner (RCBE) without a match in the Iberinform system.

• 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.

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

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030777756,
        "message": "The VAT identification number is invalid. If it's international, enter the country code at the beginning. Ex.: FR12345678901 for a French VAT identification number."
    }
}

400: Bad Request Invalid RCBE code

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030777756,
        "message": "Declaration not found for the entered RCBE code."
    }
}

400: Bad Request Expired RCBE code

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030777756,
        "message": "The code you entered is no longer valid. There is a more recent RCBE code for this entity, or a draft has been created that invalidated the previous 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.