For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LearnGraph LoginRequest a Demo
HomeAPIBulk DataSayari LibraryChange Log
  • Key Concepts
    • Introduction
    • Endpoint Overview
    • Authentication
    • Requests
    • Pagination
    • Response Status Codes
    • Data Types
    • Rate Limits
  • API Clients
    • Overview
    • Open API
    • Postman
    • Go
    • Python
    • Node
  • API Reference
      • GETTraversal
      • GETUbo
      • GETOwnership
      • GETWatchlist
      • GETShortest Path
  • Guides
    • Getting Started
    • Understanding Project Entity
    • Risk Factors
    • Entity Search
    • Advanced Entity Search
    • Resolution
    • Trade Search - Shipments
    • Trade Search - Suppliers & Buyers
    • v0 Migration
  • Implementation Patterns
    • Project Entity Supply Chain
  • Use Cases
    • Entity Screening & Verification
    • Investigations
LogoLogo
LearnGraph LoginRequest a Demo
API ReferenceTraversal

Ownership

GA
GET
/v1/downstream/:id
GET
/v1/downstream/:id
$curl -G https://api.sayari.com/v1/downstream/mGq1lpuqKssNWTjIokuPeA \
>     -H "Authorization: Bearer <token>" \
>     -d limit=1
1{
2  "min_depth": 1,
3  "max_depth": 4,
4  "relationships": [
5    "shareholder_of",
6    "beneficial_owner_of",
7    "partner_of",
8    "has_subsidiary",
9    "has_branch"
10  ],
11  "countries": [],
12  "types": [],
13  "name": "",
14  "psa": true,
15  "offset": 0,
16  "limit": 1,
17  "next": true,
18  "data": [
19    {
20      "source": "mGq1lpuqKssNWTjIokuPeA",
21      "target": {
22        "addresses": [
23          "202 HAMMERSMITH ROAD, LONDON, W6 7DN"
24        ],
25        "attribute_count": {
26          "company_type": 1,
27          "name": 2,
28          "business_purpose": 2,
29          "identifier": 1,
30          "country": 2,
31          "status": 2,
32          "address": 1
33        },
34        "closed": false,
35        "countries": [
36          "GBR"
37        ],
38        "degree": 6,
39        "entity_url": "/v1/entity/ekPP386sHXHREr15-iVgvw",
40        "id": "ekPP386sHXHREr15-iVgvw",
41        "identifiers": [
42          {
43            "value": "08661308",
44            "type": "uk_company_number",
45            "label": "Uk Company Number"
46          }
47        ],
48        "label": "BECKHAM RETAIL LIMITED",
49        "pep": false,
50        "psa_count": 0,
51        "related_entities_count": 6,
52        "relationship_count": {
53          "linked_to": 1,
54          "has_registered_agent": 1,
55          "has_director": 4,
56          "has_shareholder": 1
57        },
58        "risk": {},
59        "sanctioned": false,
60        "source_count": {
61          "ecdfb3f2ecc8c3797e77d5795a8066ef": {
62            "count": 33,
63            "label": "UK Corporate Registry"
64          },
65          "2b618f1996252fe537a6d998ae14c9b2": {
66            "count": 1,
67            "label": "UK Corporate Registry Confirmation Statements"
68          },
69          "4ea8bac1bed868e1510ffd21842e9551": {
70            "count": 23,
71            "label": "UK Persons with Significant Control"
72          }
73        },
74        "trade_count": {
75          "sent": 0,
76          "received": 0
77        },
78        "type": "company",
79        "user_attribute_count": {},
80        "user_record_count": 0,
81        "user_related_entities_count": 0,
82        "user_relationship_count": {},
83        "company_type": "Private Limited Company",
84        "latest_status": {
85          "status": "active"
86        },
87        "logistics_entity": false,
88        "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/08661308/1540252800000:6f842cf70eab52cc2178b948dea30489",
89        "registration_date": "Incorporated 2013-08-22"
90      },
91      "path": [
92        {
93          "field": "shareholder_of",
94          "entity": {
95            "addresses": [
96              "202 HAMMERSMITH ROAD, LONDON, W6 7DN"
97            ],
98            "attribute_count": {
99              "company_type": 1,
100              "name": 2,
101              "business_purpose": 2,
102              "identifier": 1,
103              "country": 2,
104              "status": 2,
105              "address": 1
106            },
107            "closed": false,
108            "countries": [
109              "GBR"
110            ],
111            "degree": 6,
112            "entity_url": "/v1/entity/ekPP386sHXHREr15-iVgvw",
113            "id": "ekPP386sHXHREr15-iVgvw",
114            "identifiers": [
115              {
116                "value": "08661308",
117                "type": "uk_company_number",
118                "label": "Uk Company Number"
119              }
120            ],
121            "label": "BECKHAM RETAIL LIMITED",
122            "pep": false,
123            "psa_count": 0,
124            "related_entities_count": 6,
125            "relationship_count": {
126              "linked_to": 1,
127              "has_registered_agent": 1,
128              "has_director": 4,
129              "has_shareholder": 1
130            },
131            "risk": {},
132            "sanctioned": false,
133            "source_count": {
134              "ecdfb3f2ecc8c3797e77d5795a8066ef": {
135                "count": 33,
136                "label": "UK Corporate Registry"
137              },
138              "2b618f1996252fe537a6d998ae14c9b2": {
139                "count": 1,
140                "label": "UK Corporate Registry Confirmation Statements"
141              },
142              "4ea8bac1bed868e1510ffd21842e9551": {
143                "count": 23,
144                "label": "UK Persons with Significant Control"
145              }
146            },
147            "trade_count": {
148              "sent": 0,
149              "received": 0
150            },
151            "type": "company",
152            "user_attribute_count": {},
153            "user_record_count": 0,
154            "user_related_entities_count": 0,
155            "user_relationship_count": {},
156            "company_type": "Private Limited Company",
157            "latest_status": {
158              "status": "active"
159            },
160            "logistics_entity": false,
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": 37653,
440  "partial_results": false
441}
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.
Was this page helpful?
Previous

Watchlist

Next
Built with

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

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, partner_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.
risk_categorieslist of enums or stringOptional
Filter paths to only those that relate with an entity that we have flagged with any risk factor of these categories
eu_high_risk_thirdbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_modern_slaverybooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
state_ownedbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
formerly_sanctionedbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_terrorismbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_organized_crimebooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_financial_crimebooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_bribery_and_corruptionbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_otherbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
reputational_risk_cybercrimebooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
regulatory_actionbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
law_enforcement_actionbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor
xinjiang_geospatialbooleanOptional
Filter paths to only those that relate with an entity that we have flagged with this risk factor

Response

This endpoint returns an object.
min_depthinteger
max_depthinteger
relationshipslist of enums
countrieslist of enums
typeslist of strings
namestring
psaboolean
offsetinteger
limitinteger
nextboolean
datalist of objects
explored_countinteger
partial_resultsboolean
sanctionedboolean
pepboolean

Errors

400
Bad Request
401
Unauthorized
404
Not Found
405
Method Not Allowed
429
Rate Limit Exceeded
500
Internal Server Error
502
Bad Gateway
520
Connection Error