Register Beneficiary

POST

https://app.rillis.io/api/v1/verification/create-beneficiary

This endpoint registers a new Beneficiary (Recipient) in the Rillis system. It is ideal for managing 'Whitelists' or frequent counterparty directories. Once registered, the beneficiary is stored for efficient reuse in future operations

Request

Body Params application/json

Examples

Responses

🟢201OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

cURL

Example 1Example 2Example 3

curl --location --request POST 'https://app.rillis.io/api/v1/verification/create-beneficiary' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "external_id": "your_external_id",
    "entity_type": "COMPANY",
    "legal_person": {
        "company_data": {
            "company_name": "REPRESENTACIONES SULBARAN SPA",
            "sector": "servicio administrativos,informaticos y recursos humanos",
            "kind_of_society": "Sociedad por Acciones (SpA)",
            "constitution_date": 1663210800000,
            "country_constitution": "CHL",
            "email": "sad@sd.cl",
            "short_description": "ACTIVIDADES COMBINADAS DE SERVICIOS ADMINISTRATIVOS DE OFICINA",
            "document_type": "CL-RUT",
            "identification_number": "776384682",
            "address": "oficina n 117,calle merced 838-A",
            "phone": "938724408",
            "company_usd_monthly_income": 5000,
            "monthly_amount_operate": 5000,
            "financial_patrimony": 5000,
            "total_patrimony": 5000,
            "source_funds": "Inversiones"
        },
        "legal_representative": [
            {
                "external_id": "AWC228232",
                "first_name": "nicolas",
                "last_name": "maduro",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "issuing_country": "CHL"
            },
            {
                "external_id": "AWC228232",
                "first_name": "nicolas",
                "last_name": "maduro",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "issuing_country": "CHL"
            }
        ],
        "final_beneficiaries": [
            {
                "external_id": "AWC316362",
                "first_name": "MICHAEL EMMANUEL",
                "last_name": "BARRIO PEREZ",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "participation": 100,
                "issuing_country": "CHL"
            },
            {
                "external_id": "AWC316362",
                "first_name": "MICHAEL EMMANUEL",
                "last_name": "BARRIO PEREZ",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "participation": 100,
                "issuing_country": "CHL"
            }
        ],
        "people_effective_control": [
            {
                "external_id": "AWC33202",
                "first_name": "MICHAEL EMMANUEL",
                "last_name": "BARRIO PEREZ",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "participation": 100,
                "issuing_country": "CHL"
            },
            {
                "external_id": "AWC33202",
                "first_name": "MICHAEL EMMANUEL",
                "last_name": "BARRIO PEREZ",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "participation": 100,
                "issuing_country": "CHL"
            },
            {
                "external_id": "AWC33202",
                "first_name": "MICHAEL EMMANUEL",
                "last_name": "BARRIO PEREZ",
                "identification_number": "256344882",
                "is_pep": false,
                "address": "tucapel jimenez 76",
                "city": "SANTIAGO",
                "country": "CHL",
                "participation": 100,
                "issuing_country": "CHL"
            }
        ]
    }
}'

Response Example

Success

{
    "external_id": "YOUR_BENEFICIARY_ID",
    "analyzed_at": 1768920489090,
    "customer_documents": [],
    "entity_type": "CRYPTO",
    "legal_person": null,
    "crypto": {
        "address": "bc1q8m4h4d92apd0s8jmwx9ywy6eamh9rl58n2a6sm",
        "network": "Bitcoin",
        "asset": "BTC"
    },
    "registered_in": 1768920400204,
    "id": "696f955022c4dfa1de6fc0a0"
}

Modified at 2026-02-06 00:15:54

Concept Details