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

{
    "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,
// }

{
    "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

{
    "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
}

{
    "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."
    }
}

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030777756,
        "message": "Declaration not found for the entered 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

}

{
    "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.

PreviousAdverse Media NextUsers

Last updated 8 months ago

Was this helpful?