Traversal

Ownership

GET
The Ownership endpoint returns paths from a single target entity to up to 50 entities directly or indirectly owned by that entity. The endpoint is a shorthand for the equivalent traversal query.

Path parameters

idstringRequired
Unique identifier of the entity

Query parameters

limitintegerOptional
Limit total values for traversal. Defaults to 10. Max of 50.
offsetintegerOptional
Offset values for traversal. Defaults to 0. Max of 1000.
min_depthintegerOptional
Set minimum depth for traversal. Defaults to 1.
max_depthintegerOptional
Set maximum depth for traversal. Defaults to 4.
relationshipsenumOptional

Set relationship type(s) to follow when traversing related entities. Defaults to shareholder_of, beneficial_owner_of, owner_of, has_subsidiary, and has_branch.

psabooleanOptional
Also traverse relationships from entities that are possibly the same as any entity that appears in the path. Defaults to traversing possibly same as relationships.
countriesenumOptional
Filter paths to only those that end at an entity associated with the specified country(ies). Defaults to returning paths that end in any country.
typesenumOptional
Filter paths to only those that end at an entity of the specified type(s). Defaults to returning paths that end at any type.
sanctionedbooleanOptional
Filter paths to only those that end at an entity appearing on a watchlist. Defaults to not filtering paths by sanctioned status.
pepbooleanOptional
Filter paths to only those that end at an entity appearing on a pep list. Defaults to not filtering paths by pep status.
min_sharesintegerOptional
Set minimum percentage of share ownership for traversal. Defaults to 0.
include_unknown_sharesbooleanOptional

Also traverse relationships when share percentages are unknown. Only useful when min_shares is set greater than 0. Defaults to true.

exclude_former_relationshipsbooleanOptional
Include relationships that were valid in the past but not at the present time. Defaults to true.
exclude_closed_entitiesbooleanOptional
Include entities that existed in the past but not at the present time. Defaults to false.
eu_high_risk_thirdbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_modern_slaverybooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
state_ownedbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
formerly_sanctionedbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_terrorismbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_organized_crimebooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_financial_crimebooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_bribery_and_corruptionbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_otherbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
reputational_risk_cybercrimebooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
regulatory_actionbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
law_enforcement_actionbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor
xinjiang_geospatialbooleanOptional
Filter paths to only those that entity with an entity that we have flagged with this risk factor

Response

This endpoint returns an object
min_depth
integer
max_depth
integer
relationships
list of enums
countries
list of enums

Country enums are normalized representations of country names. Source

types
list of strings
name
string
watchlist
boolean
psa
boolean
offset
integer
limit
integer
next
boolean
partial_results
boolean
data
list of objects
explored_count
integer
sanctioned
booleanOptional
pep
booleanOptional
GET
1curl -G https://api.sayari.com/v1/downstream/mGq1lpuqKssNWTjIokuPeA \
2     -H "Authorization: Bearer <token>" \
3     -d limit=1
200
Retrieved
1{
2  "min_depth": 1,
3  "max_depth": 4,
4  "relationships": [
5    "shareholder_of",
6    "beneficial_owner_of",
7    "owner_of",
8    "has_subsidiary",
9    "has_branch"
10  ],
11  "countries": [],
12  "types": [],
13  "name": "",
14  "watchlist": false,
15  "psa": true,
16  "offset": 0,
17  "limit": 1,
18  "next": true,
19  "partial_results": false,
20  "data": [
21    {
22      "source": "mGq1lpuqKssNWTjIokuPeA",
23      "target": {
24        "addresses": [
25          "202 HAMMERSMITH ROAD, LONDON, W6 7DN"
26        ],
27        "attribute_count": {
28          "company_type": 1,
29          "name": 2,
30          "business_purpose": 2,
31          "identifier": 1,
32          "country": 2,
33          "status": 2,
34          "address": 1
35        },
36        "closed": false,
37        "countries": [
38          "GBR"
39        ],
40        "degree": 6,
41        "entity_url": "/v1/entity/ekPP386sHXHREr15-iVgvw",
42        "id": "ekPP386sHXHREr15-iVgvw",
43        "identifiers": [
44          {
45            "value": "08661308",
46            "type": "uk_company_number",
47            "label": "Uk Company Number"
48          }
49        ],
50        "label": "BECKHAM RETAIL LIMITED",
51        "pep": false,
52        "psa_count": 0,
53        "related_entities_count": 6,
54        "relationship_count": {
55          "linked_to": 1,
56          "has_registered_agent": 1,
57          "has_director": 4,
58          "has_shareholder": 1
59        },
60        "risk": {},
61        "sanctioned": false,
62        "source_count": {
63          "ecdfb3f2ecc8c3797e77d5795a8066ef": {
64            "count": 33,
65            "label": "UK Corporate Registry"
66          },
67          "2b618f1996252fe537a6d998ae14c9b2": {
68            "count": 1,
69            "label": "UK Corporate Registry Confirmation Statements"
70          },
71          "4ea8bac1bed868e1510ffd21842e9551": {
72            "count": 23,
73            "label": "UK Persons with Significant Control"
74          }
75        },
76        "trade_count": {
77          "sent": 0,
78          "received": 0
79        },
80        "type": "company",
81        "user_attribute_count": {},
82        "user_record_count": 0,
83        "user_related_entities_count": 0,
84        "user_relationship_count": {},
85        "company_type": "Private Limited Company",
86        "latest_status": {
87          "status": "active"
88        },
89        "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/08661308/1540252800000:6f842cf70eab52cc2178b948dea30489",
90        "registration_date": "Incorporated 2013-08-22"
91      },
92      "path": [
93        {
94          "field": "shareholder_of",
95          "entity": {
96            "addresses": [
97              "202 HAMMERSMITH ROAD, LONDON, W6 7DN"
98            ],
99            "attribute_count": {
100              "company_type": 1,
101              "name": 2,
102              "business_purpose": 2,
103              "identifier": 1,
104              "country": 2,
105              "status": 2,
106              "address": 1
107            },
108            "closed": false,
109            "countries": [
110              "GBR"
111            ],
112            "degree": 6,
113            "entity_url": "/v1/entity/ekPP386sHXHREr15-iVgvw",
114            "id": "ekPP386sHXHREr15-iVgvw",
115            "identifiers": [
116              {
117                "value": "08661308",
118                "type": "uk_company_number",
119                "label": "Uk Company Number"
120              }
121            ],
122            "label": "BECKHAM RETAIL LIMITED",
123            "pep": false,
124            "psa_count": 0,
125            "related_entities_count": 6,
126            "relationship_count": {
127              "linked_to": 1,
128              "has_registered_agent": 1,
129              "has_director": 4,
130              "has_shareholder": 1
131            },
132            "risk": {},
133            "sanctioned": false,
134            "source_count": {
135              "ecdfb3f2ecc8c3797e77d5795a8066ef": {
136                "count": 33,
137                "label": "UK Corporate Registry"
138              },
139              "2b618f1996252fe537a6d998ae14c9b2": {
140                "count": 1,
141                "label": "UK Corporate Registry Confirmation Statements"
142              },
143              "4ea8bac1bed868e1510ffd21842e9551": {
144                "count": 23,
145                "label": "UK Persons with Significant Control"
146              }
147            },
148            "trade_count": {
149              "sent": 0,
150              "received": 0
151            },
152            "type": "company",
153            "user_attribute_count": {},
154            "user_record_count": 0,
155            "user_related_entities_count": 0,
156            "user_relationship_count": {},
157            "company_type": "Private Limited Company",
158            "latest_status": {
159              "status": "active"
160            },
161            "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/08661308/1540252800000:6f842cf70eab52cc2178b948dea30489",
162            "registration_date": "Incorporated 2013-08-22"
163          },
164          "relationships": {
165            "linked_to": {
166              "values": [
167                {
168                  "record": "4ea8bac1bed868e1510ffd21842e9551/08661308/1560176240192",
169                  "attributes": {
170                    "position": [
171                      {
172                        "value": "Has right to appoint and remove directors"
173                      },
174                      {
175                        "value": "Owns 75-100% of shares"
176                      },
177                      {
178                        "value": "Owns 75-100% of voting rights"
179                      }
180                    ]
181                  },
182                  "acquisition_date": "2019-06-10"
183                },
184                {
185                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1586822400000",
186                  "attributes": {},
187                  "acquisition_date": "2020-04-14"
188                },
189                {
190                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1601424000000",
191                  "attributes": {},
192                  "acquisition_date": "2020-09-30"
193                },
194                {
195                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1616630400000",
196                  "attributes": {},
197                  "acquisition_date": "2021-03-25"
198                },
199                {
200                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1634169600000",
201                  "attributes": {},
202                  "acquisition_date": "2021-10-14"
203                },
204                {
205                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1649894400000",
206                  "attributes": {},
207                  "acquisition_date": "2022-04-14"
208                },
209                {
210                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1667433600000",
211                  "attributes": {},
212                  "acquisition_date": "2022-11-03"
213                },
214                {
215                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1675123200000",
216                  "attributes": {},
217                  "acquisition_date": "2023-01-31"
218                },
219                {
220                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1676505600000",
221                  "attributes": {},
222                  "acquisition_date": "2023-02-16"
223                },
224                {
225                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1678320000000",
226                  "attributes": {},
227                  "acquisition_date": "2023-03-09"
228                },
229                {
230                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1680566400000",
231                  "attributes": {},
232                  "acquisition_date": "2023-04-04"
233                },
234                {
235                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1682899200000",
236                  "attributes": {},
237                  "acquisition_date": "2023-05-01"
238                },
239                {
240                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1685577600000",
241                  "attributes": {},
242                  "acquisition_date": "2023-06-01"
243                },
244                {
245                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1689033600000",
246                  "attributes": {},
247                  "acquisition_date": "2023-07-11"
248                },
249                {
250                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1692662400000",
251                  "attributes": {},
252                  "acquisition_date": "2023-08-22"
253                },
254                {
255                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1694476800000",
256                  "attributes": {},
257                  "acquisition_date": "2023-09-12"
258                },
259                {
260                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1696896000000",
261                  "attributes": {},
262                  "acquisition_date": "2023-10-10"
263                },
264                {
265                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1699488000000",
266                  "attributes": {},
267                  "acquisition_date": "2023-11-09"
268                },
269                {
270                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1702252800000",
271                  "attributes": {},
272                  "acquisition_date": "2023-12-11"
273                },
274                {
275                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1704067200000",
276                  "attributes": {},
277                  "acquisition_date": "2024-01-01"
278                },
279                {
280                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1706832000000",
281                  "attributes": {},
282                  "acquisition_date": "2024-02-02"
283                },
284                {
285                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1709596800000",
286                  "attributes": {},
287                  "acquisition_date": "2024-03-05"
288                },
289                {
290                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1711843200000",
291                  "attributes": {},
292                  "acquisition_date": "2024-03-31"
293                }
294              ],
295              "last_observed": "2024-03-31"
296            },
297            "shareholder_of": {
298              "values": [
299                {
300                  "record": "4ea8bac1bed868e1510ffd21842e9551/08661308/1560176240192",
301                  "attributes": {
302                    "position": [
303                      {
304                        "value": "Has right to appoint and remove directors"
305                      },
306                      {
307                        "value": "Owns 75-100% of shares"
308                      },
309                      {
310                        "value": "Owns 75-100% of voting rights"
311                      }
312                    ],
313                    "shares": [
314                      {
315                        "percentage": 75
316                      }
317                    ]
318                  },
319                  "acquisition_date": "2019-06-10"
320                },
321                {
322                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1586822400000",
323                  "attributes": {},
324                  "acquisition_date": "2020-04-14"
325                },
326                {
327                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1601424000000",
328                  "attributes": {},
329                  "acquisition_date": "2020-09-30"
330                },
331                {
332                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1616630400000",
333                  "attributes": {},
334                  "acquisition_date": "2021-03-25"
335                },
336                {
337                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1634169600000",
338                  "attributes": {},
339                  "acquisition_date": "2021-10-14"
340                },
341                {
342                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1649894400000",
343                  "attributes": {},
344                  "acquisition_date": "2022-04-14"
345                },
346                {
347                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1667433600000",
348                  "attributes": {},
349                  "acquisition_date": "2022-11-03"
350                },
351                {
352                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1675123200000",
353                  "attributes": {},
354                  "acquisition_date": "2023-01-31"
355                },
356                {
357                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1676505600000",
358                  "attributes": {},
359                  "acquisition_date": "2023-02-16"
360                },
361                {
362                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1678320000000",
363                  "attributes": {},
364                  "acquisition_date": "2023-03-09"
365                },
366                {
367                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1680566400000",
368                  "attributes": {},
369                  "acquisition_date": "2023-04-04"
370                },
371                {
372                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1682899200000",
373                  "attributes": {},
374                  "acquisition_date": "2023-05-01"
375                },
376                {
377                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1685577600000",
378                  "attributes": {},
379                  "acquisition_date": "2023-06-01"
380                },
381                {
382                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1689033600000",
383                  "attributes": {},
384                  "acquisition_date": "2023-07-11"
385                },
386                {
387                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1692662400000",
388                  "attributes": {},
389                  "acquisition_date": "2023-08-22"
390                },
391                {
392                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1694476800000",
393                  "attributes": {},
394                  "acquisition_date": "2023-09-12"
395                },
396                {
397                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1696896000000",
398                  "attributes": {},
399                  "acquisition_date": "2023-10-10"
400                },
401                {
402                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1699488000000",
403                  "attributes": {},
404                  "acquisition_date": "2023-11-09"
405                },
406                {
407                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1702252800000",
408                  "attributes": {},
409                  "acquisition_date": "2023-12-11"
410                },
411                {
412                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1704067200000",
413                  "attributes": {},
414                  "acquisition_date": "2024-01-01"
415                },
416                {
417                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1706832000000",
418                  "attributes": {},
419                  "acquisition_date": "2024-02-02"
420                },
421                {
422                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1709596800000",
423                  "attributes": {},
424                  "acquisition_date": "2024-03-05"
425                },
426                {
427                  "record": "4ea8bac1bed868e1510ffd21842e9551/ef8cbb3fcc71d09f098f00728df231e8/1711843200000",
428                  "attributes": {},
429                  "acquisition_date": "2024-03-31"
430                }
431              ],
432              "last_observed": "2024-03-31"
433            }
434          }
435        }
436      ]
437    }
438  ],
439  "explored_count": 9999999
440}
Built with