Entity

Get Entity

GET
Retrieve an entity from the database based on the ID

Path parameters

idstringRequired
Unique identifier of the entity

Query parameters

attributes.additional_information.nextstringOptional

The pagination token for the next page of attribute additional_information.

attributes.additional_information.prevstringOptional

The pagination token for the previous page of attribute additional_information.

attributes.additional_information.limitintegerOptional

Limit total values returned for attribute additional_information. Defaults to 100.

attributes.address.nextstringOptional

The pagination token for the next page of attribute address.

attributes.address.prevstringOptional

The pagination token for the previous page of attribute address.

attributes.address.limitintegerOptional

Limit total values returned for attribute address. Defaults to 100.

attributes.business_purpose.nextstringOptional

The pagination token for the next page of attribute business_purpose.

attributes.business_purpose.prevstringOptional

The pagination token for the previous page of attribute business_purpose.

attributes.business_purpose.limitintegerOptional

Limit total values returned for attribute business_purpose. Defaults to 100.

attributes.company_type.nextstringOptional

The pagination token for the next page of attribute company_type.

attributes.company_type.prevstringOptional

The pagination token for the previous page of attribute company_type.

attributes.company_type.limitintegerOptional

Limit total values returned for attribute company_type. Defaults to 100.

attributes.country.nextstringOptional

The pagination token for the next page of attribute country.

attributes.country.prevstringOptional

The pagination token for the previous page of attribute country.

attributes.country.limitintegerOptional

Limit total values returned for attribute country. Defaults to 100.

attributes.identifier.nextstringOptional

The pagination token for the next page of attribute identifier.

attributes.identifier.prevstringOptional

The pagination token for the previous page of attribute identifier.

attributes.identifier.limitintegerOptional

Limit total values returned for attribute identifier. Defaults to 100.

attributes.name.nextstringOptional

The pagination token for the next page of attribute name.

attributes.name.prevstringOptional

The pagination token for the previous page of attribute name.

attributes.name.limitintegerOptional

Limit total values returned for attribute name. Defaults to 100.

attributes.status.nextstringOptional

The pagination token for the next page of attribute status.

attributes.status.prevstringOptional

The pagination token for the previous page of attribute status.

attributes.status.limitintegerOptional

Limit total values returned for attribute status. Defaults to 100.

relationships.nextstringOptional
The pagination token for the next page of relationship results
relationships.prevstringOptional
The pagination token for the previous page of relationship results
relationships.limitintegerOptional
Limit total relationship values. Defaults to 50.
relationships.typeenumOptional
relationships.sortstringOptional
Sorts relationships by As Of date or Shareholder percentage, e.g. date or -shares
relationships.startDatedateOptional
Filters relationships to after a date
relationships.endDatedateOptional
Filters relationships to before a date
relationships.minSharesintegerOptional
Filters relationships to greater than or equal to a Shareholder percentage
relationships.countryenumOptional
relationships.arrivalCountryenumOptional

Filters shipment relationships to a list of arrival countries

relationships.arrivalStatestringOptional
Filters shipment relationships to an arrival state
relationships.arrivalCitystringOptional
Filters shipment relationships to an arrival city
relationships.departureCountryenumOptional

Filters shipment relationships to a list of departure countries

relationships.departureStatestringOptional
Filters shipment relationships to a departure state
relationships.departureCitystringOptional
Filters shipment relationships to a departure city
relationships.partnerNamestringOptional
Filters shipment relationships to a trade partner name
relationships.partnerRiskenumOptional

Filters shipment relationships to a trade partner risk tag

relationships.hsCodestringOptional
Filters shipment relationships to an HS code
possibly_same_as.nextstringOptional
The pagination token for the next page of possibly same entities.
possibly_same_as.prevstringOptional
The pagination token for the previous page of possibly same entities.
possibly_same_as.limitintegerOptional
Limit total possibly same as entities. Defaults to 100.
referenced_by.nextstringOptional
The pagination token for the next page of the entity's referencing records
referenced_by.prevstringOptional
The pagination token for the previous page of the entity's referencing records
referenced_by.limitintegerOptional
Limit totals values returned for entity's referencing records. Defaults to 100.

Response

This endpoint returns an object
addresses
list of strings

List of physical addresses associated with the entity. See more here

attribute_count
map from enums to integers
closed
boolean
True if the entity existed in the past but not at the present time, otherwise false. Always false for data curation.
countries
list of enums
degree
integer
Number of outgoing relationships
entity_url
string
Convenience URL to the entity in the API.
id
string
Unique identifier of the entity
identifiers
list of objects
Identifiers associated with the entity.
label
string
Display name of the entity
pep
boolean
psa_count
integer
Number of entities that are Possibly the Same As (PSA) the entity.
related_entities_count
integer
relationship_count
map from enums to integers
risk
map from enums to objects
sanctioned
boolean
source_count
map from strings to objects
Number of records associated with the entity, grouped by source.
trade_count
map from strings to integers
type
enum
user_attribute_count
map from enums to integers
user_record_count
integer
user_related_entities_count
integer
user_relationship_count
map from enums to integers
attributes
objectOptional

Detailed information about the entity’s attributes.

company_type
stringOptional
A type of legal entity in a given jurisdiction (e.g. 'LLC,' 'Sociedad Anonima,' 'Private Company Limited by Shares')
date_of_birth
stringOptional

Birth date of a person. See more here

hs_code
stringOptional
Harmonized Tariff Schedule Code associated with the entity/shipment
latest_status
objectOptional
The most recent status of an entity and when that status was observed.
possibly_same_as
objectOptional
List of entities that are Possibly the Same As (PSA) the entity.
psa_id
stringOptional
reference_id
stringOptional
referenced_by
objectOptional
List of records that reference the entity.
registration_date
stringOptional
Type (registered/incorporated/active) and date of the earliest significant activity associated with the entity. Will appear as 'Registered YYYY-MM-DD'
relationships
objectOptional
shipment_arrival
stringOptional
Arrival date of a shipment.
shipment_departure
stringOptional
Departure date of a shipment.
translated_label
stringOptional
Label in English if available. Translation performed by Sayari.
GET
1curl -G https://api.sayari.com/v1/entity/mGq1lpuqKssNWTjIokuPeA \
2     -H "Authorization: Bearer <token>" \
3     -d attributes.name.limit=1 \
4     -d attributes.address.limit=1 \
5     -d attributes.country.limit=1 \
6     -d attributes.additional_information.limit=1 \
7     -d attributes.business_purpose.limit=1 \
8     -d attributes.company_type.limit=1 \
9     -d attributes.identifier.limit=1 \
10     -d attributes.status.limit=1 \
11     -d relationships.limit=1 \
12     -d possibly_same_as.limit=1 \
13     -d referenced_by.limit=1
200
Retrieved
1{
2  "addresses": [
3    "202 HAMMERSMITH ROAD , LONDON , , UNITED KINGDOM , W6 7DN , GB",
4    "Unit 33, Ransomes Dock Business Centre, 35-37 Parkgate Road, London SW11 4NP",
5    "SAUNDERS BUILDING, 202 HAMMERSMITH ROAD, HAMMERSMITH, LONDON"
6  ],
7  "attribute_count": {
8    "company_type": 2,
9    "name": 2,
10    "business_purpose": 4,
11    "identifier": 3,
12    "additional_information": 106,
13    "country": 8,
14    "status": 5,
15    "address": 7
16  },
17  "closed": false,
18  "countries": [
19    "GBR",
20    "USA"
21  ],
22  "degree": 67,
23  "entity_url": "/v1/entity/mGq1lpuqKssNWTjIokuPeA",
24  "id": "mGq1lpuqKssNWTjIokuPeA",
25  "identifiers": [
26    {
27      "value": "06517802",
28      "type": "uk_company_number",
29      "label": "Uk Company Number"
30    },
31    {
32      "value": "6517802",
33      "type": "unknown",
34      "label": "Unknown"
35    },
36    {
37      "value": "04781466",
38      "type": "ca_corporate_id_num",
39      "label": "Ca Corporate Id Num"
40    }
41  ],
42  "label": "VICTORIA BECKHAM LIMITED",
43  "pep": false,
44  "psa_count": 3,
45  "related_entities_count": 67,
46  "relationship_count": {
47    "linked_to": 3,
48    "has_officer": 2,
49    "shareholder_of": 1,
50    "has_shareholder": 2,
51    "has_registered_agent": 5,
52    "shipper_of": 41,
53    "has_director": 11,
54    "owner_of": 3,
55    "has_founder": 1,
56    "ships_to": 1
57  },
58  "risk": {
59    "basel_aml": {
60      "value": 4.63,
61      "metadata": {
62        "country": [
63          "USA"
64        ]
65      },
66      "level": "relevant"
67    },
68    "cpi_score": {
69      "value": 67,
70      "metadata": {
71        "country": [
72          "USA"
73        ]
74      },
75      "level": "relevant"
76    }
77  },
78  "sanctioned": false,
79  "source_count": {
80    "2b618f1996252fe537a6d998ae14c9b2": {
81      "count": 1,
82      "label": "UK Corporate Registry Confirmation Statements"
83    },
84    "2b788dbdf9194ed5a5c309386a6516b1": {
85      "count": 28,
86      "label": "UK HM Revenue & Customs Traders Database"
87    },
88    "a447a7b622c4ead6e1caf94983dc2337": {
89      "count": 6,
90      "label": "USA California Secretary of State"
91    },
92    "ecdfb3f2ecc8c3797e77d5795a8066ef": {
93      "count": 35,
94      "label": "UK Corporate Registry"
95    },
96    "e5de7b52cc88ef4cd1a10e201bdf46ee": {
97      "count": 41,
98      "label": "Vietnam Imports & Exports (January 2023 - Present)"
99    },
100    "2a4fe9a14e332c8f9ded1f8a457c2b89": {
101      "count": 36,
102      "label": "UK Land Commercial and Corporate Ownership Data (CCOD)"
103    },
104    "4ea8bac1bed868e1510ffd21842e9551": {
105      "count": 69,
106      "label": "UK Persons with Significant Control"
107    }
108  },
109  "trade_count": {
110    "sent": 41,
111    "received": 0
112  },
113  "type": "company",
114  "user_attribute_count": {},
115  "user_record_count": 0,
116  "user_related_entities_count": 0,
117  "user_relationship_count": {},
118  "attributes": {
119    "additional_information": {
120      "data": [
121        {
122          "properties": {
123            "type": "Traded Goods"
124          },
125          "record": [
126            "2b788dbdf9194ed5a5c309386a6516b1/22950249e3df0c33ce05bd54850ba9f3/1672444800000"
127          ],
128          "record_count": 9,
129          "editable": false
130        }
131      ],
132      "limit": 1,
133      "size": {
134        "count": 106,
135        "qualifier": "eq"
136      },
137      "next": "_SjfEipa7hytJ93C1IT_sg"
138    },
139    "address": {
140      "data": [
141        {
142          "properties": {
143            "normalized": "202 HAMMERSMITH KINGDOM RD UNITED",
144            "country": "United Kingdom",
145            "house_number": "202",
146            "precision_code": "G3",
147            "road": "Hammersmith Road",
148            "value": "202 HAMMERSMITH ROAD UNITED KINGDOM",
149            "x": -0.22579,
150            "y": 51.49291
151          },
152          "record": [
153            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1678752000000"
154          ],
155          "record_count": 5,
156          "editable": false
157        }
158      ],
159      "limit": 1,
160      "size": {
161        "count": 7,
162        "qualifier": "eq"
163      },
164      "next": "5TPSsmsFxea24_QTyk8o1Q"
165    },
166    "business_purpose": {
167      "data": [
168        {
169          "properties": {
170            "code": "9329",
171            "standard": "ISIC4",
172            "value": "Other amusement and recreation activities n.e.c."
173          },
174          "record": [
175            "9aef3a56aa0ea25404b498dbd8bb447f/06517802/1579014552807"
176          ],
177          "record_count": 18,
178          "editable": false
179        }
180      ],
181      "limit": 1,
182      "size": {
183        "count": 4,
184        "qualifier": "eq"
185      },
186      "next": "5fZrn5ZbUyo6d_huc6NlAA"
187    },
188    "company_type": {
189      "data": [
190        {
191          "properties": {
192            "value": "Stock Corporation - Out of State - Stock"
193          },
194          "record": [
195            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1649116800000"
196          ],
197          "record_count": 6,
198          "editable": false
199        }
200      ],
201      "limit": 1,
202      "size": {
203        "count": 2,
204        "qualifier": "eq"
205      },
206      "next": "iuJ_MCygy24sDCcVkbCATA"
207    },
208    "country": {
209      "data": [
210        {
211          "properties": {
212            "value": "GBR",
213            "context": "address"
214          },
215          "record": [
216            "9aef3a56aa0ea25404b498dbd8bb447f/06517802/1579014552807"
217          ],
218          "record_count": 23,
219          "editable": false
220        }
221      ],
222      "limit": 1,
223      "size": {
224        "count": 8,
225        "qualifier": "eq"
226      },
227      "next": "_ZTsEnhxCbjokYYWu1kMoQ"
228    },
229    "identifier": {
230      "data": [
231        {
232          "properties": {
233            "type": "ca_corporate_id_num",
234            "value": "04781466"
235          },
236          "record": [
237            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1649116800000"
238          ],
239          "record_count": 6,
240          "editable": false
241        }
242      ],
243      "limit": 1,
244      "size": {
245        "count": 3,
246        "qualifier": "eq"
247      },
248      "next": "07v3Rsu6x-gDuukFa0jEsw"
249    },
250    "name": {
251      "data": [
252        {
253          "properties": {
254            "value": "BECKHAM VENTURES LIMITED",
255            "context": "alias",
256            "to_date": "2014-09-03"
257          },
258          "record": [
259            "2a4fe9a14e332c8f9ded1f8a457c2b89/NGL944625/1560779151522"
260          ],
261          "record_count": 30,
262          "editable": false
263        }
264      ],
265      "limit": 1,
266      "size": {
267        "count": 2,
268        "qualifier": "eq"
269      },
270      "next": "5lxpjuZmt31xiCnbDILp0A"
271    },
272    "status": {
273      "data": [
274        {
275          "properties": {
276            "text": "Good"
277          },
278          "record": [
279            "9139b58de1bdb0157a1a1e54e56df6d3/4781466/1649116800000"
280          ],
281          "record_count": 6,
282          "editable": false
283        }
284      ],
285      "limit": 1,
286      "size": {
287        "count": 5,
288        "qualifier": "eq"
289      },
290      "next": "EdC1n7V2lU0oKTokzO_YLw"
291    }
292  },
293  "company_type": "Stock Corporation - Out of State - Stock",
294  "latest_status": {
295    "status": "active",
296    "date": "2023-08-29"
297  },
298  "possibly_same_as": {
299    "data": [
300      {
301        "entity": {
302          "addresses": [
303            "99 WASHINGTON AVE., SUITE 805A, ALBANY, NY, 12201",
304            "511 WEST 25TH STREET, SUITE # 701/7TH FLOOR, NEW YORK, NEW YORK, 10001",
305            "80 STATE STREET, ALBANY, NEW YORK, 12207-2543"
306          ],
307          "attribute_count": {
308            "company_type": 1,
309            "name": 1,
310            "identifier": 1,
311            "country": 3,
312            "status": 1,
313            "address": 3
314          },
315          "closed": false,
316          "countries": [
317            "USA"
318          ],
319          "degree": 3,
320          "entity_url": "/v1/entity/NGUTEUTI4YZ6R5d56vgNIw",
321          "id": "NGUTEUTI4YZ6R5d56vgNIw",
322          "identifiers": [
323            {
324              "value": "4346762",
325              "type": "usa_ny_dos_id",
326              "label": "Usa Ny Dos Id"
327            }
328          ],
329          "label": "BECKHAM VENTURES INC.",
330          "pep": false,
331          "psa_count": 3,
332          "related_entities_count": 3,
333          "relationship_count": {
334            "has_officer": 1,
335            "has_registered_agent": 2,
336            "linked_to": 2
337          },
338          "risk": {
339            "basel_aml": {
340              "value": 4.63,
341              "metadata": {
342                "country": [
343                  "USA"
344                ]
345              },
346              "level": "relevant"
347            },
348            "cpi_score": {
349              "value": 67,
350              "metadata": {
351                "country": [
352                  "USA"
353                ]
354              },
355              "level": "relevant"
356            }
357          },
358          "sanctioned": false,
359          "source_count": {
360            "b4d06d4b77f51fab3c77c9653aabdda4": {
361              "count": 8,
362              "label": "USA New York Corporate Registry (Active Entities)"
363            }
364          },
365          "trade_count": {
366            "sent": 0,
367            "received": 0
368          },
369          "type": "company",
370          "user_attribute_count": {},
371          "user_record_count": 0,
372          "user_related_entities_count": 0,
373          "user_relationship_count": {},
374          "company_type": "FOREIGN BUSINESS CORPORATION",
375          "latest_status": {
376            "status": "active",
377            "date": "2013-01-16"
378          },
379          "psa_id": "695785012897",
380          "reference_id": "b4d06d4b77f51fab3c77c9653aabdda4/a80e7f4c-c219-437b-9941-32d89ea5885a/1560542045043:15d813b260619393762864f22d3c5b2d",
381          "registration_date": " 2013-01-16"
382        },
383        "matches": {},
384        "editable": false
385      }
386    ],
387    "limit": 1,
388    "size": {
389      "count": 3,
390      "qualifier": "eq"
391    },
392    "next": "eyJ0eXBlIjoic2F5YXJpIiwib2Zmc2V0IjoxfQ"
393  },
394  "psa_id": "695785012897",
395  "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/06517802/1540252800000:4a34442eccf1622995130b194a5d50e7",
396  "referenced_by": {
397    "data": [
398      {
399        "record": {
400          "id": "e5de7b52cc88ef4cd1a10e201bdf46ee/{D634B9B1-39E2-4273-8F35AE81130E18D7}/1704240000000",
401          "label": "Trade Record from Vietnam Imports & Exports (January 2023 - Present)",
402          "source": "e5de7b52cc88ef4cd1a10e201bdf46ee",
403          "acquisition_date": "2024-01-03",
404          "references_count": 3,
405          "record_url": "/record/e5de7b52cc88ef4cd1a10e201bdf46ee%2F%7BD634B9B1-39E2-4273-8F35AE81130E18D7%7D%2F1704240000000",
406          "publication_date": "2024-01-03"
407        },
408        "type": "mentions"
409      }
410    ],
411    "limit": 1,
412    "size": {
413      "count": 216,
414      "qualifier": "eq"
415    },
416    "next": "Vk5NfGdsb2JhbF90cmFkZV90YV92bm18ZnwyMDI0LTAxLTAzfHtENjM0QjlCMS0zOUUyLTQyNzMtOEYzNUFFODExMzBFMThEN318MTcwNDI0MDAwMDAwMA"
417  },
418  "registration_date": "Incorporated 2008-02-28",
419  "relationships": {
420    "data": [
421      {
422        "target": {
423          "addresses": [
424            "35-37 Parkgate Road, London, SW11 4NP",
425            "Hammersmith Road, London",
426            "202 HAMMERSMITH ROAD, LONDON, W6 7DN"
427          ],
428          "attribute_count": {
429            "company_type": 1,
430            "name": 2,
431            "business_purpose": 3,
432            "identifier": 1,
433            "additional_information": 1,
434            "country": 3,
435            "status": 2,
436            "address": 3
437          },
438          "closed": false,
439          "countries": [
440            "GBR"
441          ],
442          "degree": 17,
443          "entity_url": "/v1/entity/zenMMQtpFHx9Cam_2nDndg",
444          "id": "zenMMQtpFHx9Cam_2nDndg",
445          "identifiers": [
446            {
447              "value": "11043864",
448              "type": "uk_company_number",
449              "label": "Uk Company Number"
450            }
451          ],
452          "label": "Victoria Beckham Holdings Limited",
453          "pep": false,
454          "psa_count": 0,
455          "related_entities_count": 17,
456          "relationship_count": {
457            "shareholder_of": 2,
458            "has_shareholder": 5,
459            "has_registered_agent": 1,
460            "has_director": 9,
461            "linked_to": 7
462          },
463          "risk": {
464            "basel_aml": {
465              "value": 3.99,
466              "metadata": {
467                "country": [
468                  "GBR"
469                ]
470              },
471              "level": "relevant"
472            },
473            "cpi_score": {
474              "value": 78,
475              "metadata": {
476                "country": [
477                  "GBR"
478                ]
479              },
480              "level": "relevant"
481            }
482          },
483          "sanctioned": false,
484          "source_count": {
485            "ecdfb3f2ecc8c3797e77d5795a8066ef": {
486              "count": 34,
487              "label": "UK Corporate Registry"
488            },
489            "2b618f1996252fe537a6d998ae14c9b2": {
490              "count": 1,
491              "label": "UK Corporate Registry Confirmation Statements"
492            },
493            "4ea8bac1bed868e1510ffd21842e9551": {
494              "count": 147,
495              "label": "UK Persons with Significant Control"
496            }
497          },
498          "trade_count": {
499            "sent": 0,
500            "received": 0
501          },
502          "type": "company",
503          "user_attribute_count": {},
504          "user_record_count": 0,
505          "user_related_entities_count": 0,
506          "user_relationship_count": {},
507          "company_type": "Private Limited Company",
508          "latest_status": {
509            "status": "active"
510          },
511          "reference_id": "ecdfb3f2ecc8c3797e77d5795a8066ef/11043864/1540252800000:40ec7b0310d308ebf9006148b53a2802",
512          "registration_date": "Incorporated 2017-11-02"
513        },
514        "types": {
515          "has_shareholder": [
516            {
517              "record": "4ea8bac1bed868e1510ffd21842e9551/56910fae410d43596d5a94fd9405023a/1711843200000",
518              "attributes": {},
519              "acquisition_date": "2024-03-31",
520              "editable": false
521            },
522            {
523              "record": "4ea8bac1bed868e1510ffd21842e9551/06517802/1560176240192",
524              "attributes": {
525                "position": [
526                  {
527                    "value": "Has right to appoint and remove directors"
528                  },
529                  {
530                    "value": "Owns 75-100% of shares"
531                  },
532                  {
533                    "value": "Owns 75-100% of voting rights"
534                  }
535                ],
536                "shares": [
537                  {
538                    "percentage": 75
539                  }
540                ]
541              },
542              "acquisition_date": "2019-06-10",
543              "editable": false
544            }
545          ],
546          "linked_to": [
547            {
548              "record": "4ea8bac1bed868e1510ffd21842e9551/56910fae410d43596d5a94fd9405023a/1711843200000",
549              "attributes": {},
550              "acquisition_date": "2024-03-31",
551              "editable": false
552            },
553            {
554              "record": "4ea8bac1bed868e1510ffd21842e9551/06517802/1560176240192",
555              "attributes": {
556                "position": [
557                  {
558                    "value": "Has right to appoint and remove directors"
559                  },
560                  {
561                    "value": "Owns 75-100% of shares"
562                  },
563                  {
564                    "value": "Owns 75-100% of voting rights"
565                  }
566                ]
567              },
568              "acquisition_date": "2019-06-10",
569              "editable": false
570            }
571          ]
572        },
573        "dates": [
574          "2017-11-16"
575        ],
576        "first_observed": "2017-11-16",
577        "last_observed": "2017-11-16"
578      }
579    ],
580    "limit": 1,
581    "size": {
582      "count": 67,
583      "qualifier": "eq"
584    },
585    "next": "fzenMMQtpFHx9Cam_2nDndg"
586  }
587}
Built with