Individuals and Wealth Profile API

Table of contents

How to query

In order to retrieve a wealth profile you need an individual’s ID, obtained from the Acuris HNWI Search API:

{
	{…},
	"results": [
		{
			"id": "prime-000000"
			{…},
		},
		{…}
	]
}

You can then call the HNWI Profile API endpoint and get the wealth profile:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals/{id}/profile

Response

The response will include name, roles in companies, date of birth, nationality, contact information, total wealth and its breakdown by category, civil status and progeny, acquaintances, other information, interests and sports as well as education and other achievements for all individuals with a wealth profile:

{
    "id": "prime-111102",
    "fullName": "Payton Harley Dallas",
    "roles": [
        {
            "mmgid": "prime-shareholder",
            "name": "Shareholder",
            "company": {
                "mmgid": "prime-2494",
                "name": "The Media Inc"
            },
            "stake": 10
        },
    ],
    "birthDate": "1950-07-18T00:00:00.000Z",
    "addresses": [
        {
            "id": "83682",
            "address2": "Becker Inland",
            "address3": "The Volley",
            "city": "Virgin Gorda",
            "country": {
                "mmgid": "prime-BVI",
                "name": "British Virgin Islands"
            },
            "typeCode": {
                "mmgid": "prime-home",
                "name": "home"
            },
            "isMain": true
        },
        {
            "id": "386471",
            "country": {
                "mmgid": "prime-GBR",
                "name": "United Kingdom"
            },
            "typeCode": {
                "mmgid": "prime-work",
                "name": "work"
            },
            "isMain": false
        }
    ],
    "wealthSummary": {
        "totalWealth": {
            "valueInMillions": [
                {
                    "currencyCode": "USD",
                    "minValue": 6691.528,
                    "maxValue": 6691.528
                },
                {…}
            ]
        },
        "potentialWealth": {
            "valueInMillions": [
                {
                    "currencyCode": "GBP",
                    "minValue": 2131.8084,
                    "maxValue": 2131.8084
                },
                {…}
            ]
        },
        "completedWealth": {
            "valueInMillions": [
                {
                    "currencyCode": "EUR",
                    "minValue": 1794.1367,
                    "maxValue": 1794.1367
                },
                {…}
            ]
        },
        "assets": {
            "valueInMillions": [
                {
                    "currencyCode": "GBP",
                    "minValue": 523.5501,
                    "maxValue": 523.5501
                },
                {…}
            ]
        }
    },
    "publishDate": "2018-06-22T00:00:00.000Z",
    "maritalStatus": {
        "code": {
            "mmgid": "prime-married",
            "name": "married"
        },
        "details": "Second spouse's name: Joanne Templeton"
    },
    "progeny": 3,
    "othernote": "Payton Harely Dallas is a British business magnate, author and investor. …",
    "interests": "- Social media: twitter.com/paytonharley - Charity: …",
    "achievements": [
        {
            "details": "Ranked in Time Magazine Top 100 Most Influential People in the World.",
            "year": 2007
        },
        {…}
    ],
    "lastUpdated": "2020-06-04T00:00:00.000Z",
    "acquaintances": [
        {
            "relatedIndividualId": "prime-179989",
            "fullName": "Ivy-Rose Copelanad",
            "notes": "Co-founder of The Media Inc."
        },
        {…}
    ],
    "education": [
        {
            "institution": "Stowe School"
        }
    ]
}

For individuals whose profile haven’t been researched by the Wealthmonitor team the response provides the name.