Individuals and Wealth Search API

How to query

You can use the query below to get the individuals included in your API subscription:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals/

You can query the API for specific criteria by adding one or more parameters to the API call. The response will only include individuals matching at least one of the criteria specified.

Multiple criteria are interpreted using AND condition, whereas multiple values for the same criteria are interpreted with OR condition. For example to get all individuals with at least one shareholding position and total wealth of 5M USD and above, use:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals/?wealthValueFrom=5&wealthValueCurrency=USD&role=prime-shareholder

To get all individuals with at least one shareholding or ownership position and total wealth of 5M USD and above, use:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals/?wealthValueFrom=5&wealthValueCurrency=USD&role=prime-shareholder,prime-owner

Pagination

Results are returned by the API in blocks of 20 items per page. The position of the first item in the active response is identified by the value ‘firstCursor’ and the value ‘lastCursor’ identifies the position of the last item of the active response:

{
    "hits": 72446,
    "results": [
        {…},
        {…}
    ],
    "firstCursor": "MjAyMDA4MTAxMTAwNDIwMDBwcmltZS0zMDg0MjU3.57053024",
    "lastCursor": "MjAyMDA4MTAxMTAwMDkyODdpbnRlbGNtcy1tNGN0Y3g=.34b9330d"
}

To paginate through the whole response you have to use the query parameters ‘pageAfter’ and ‘pageBefore’.

Passing the value of ‘lastCursor’ to ‘pageAfter’ in the API query will yield the next 20 items:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals?pageAfter=MjAyMDA4MTAxMTAwMDkyODdpbnRlbGNtcy1tNGN0Y3g=.34b9330d

Passing the value of ‘firstCursor’ to ‘pageBefore’ in the API query will yield the previous 20 items:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals?pageBefore=MjAyMDA4MTAxMTAwNDIwMDBwcmltZS0zMDg0MjU3.57053024

When there are no pages left to return, the response will look similar to the following:

[{
   "hits": 2020, 
   "results": [], 
   "lastCursor": "MTU1MzY0NDgwMDAwMF85MjA0OTU=.11ee9c92"
}]