Get Record

GET

/v1/record/:id

GET

/v1/record/:id

1 import requests
2 
3 url = "https://api.sayari.com/v1/record/74cf0fc2a62f9c8f4e88f8a0b3ffcca4%252FF0000110%252F1682970471254"
4 
5 headers = {"Authorization": "<token>."}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

1 {
2   "acquisition_date": "2023-05-01",
3   "id": "74cf0fc2a62f9c8f4e88f8a0b3ffcca4%2FF0000110%2F1682970471254",
4   "label": "Company Record from Hong Kong Companies Registry",
5   "record_url": "/v1/record/74cf0fc2a62f9c8f4e88f8a0b3ffcca4%2FF0000110%2F1682970471254",
6   "references": {
7     "data": [
8       {
9         "entity": {
10           "id": "YUc8LtKFCpAbUIBGK8nQpw",
11           "label": "Bank of China Ltd.",
12           "degree": 22179,
13           "entity_url": "/v1/entity/YUc8LtKFCpAbUIBGK8nQpw",
14           "pep": false,
15           "psa_id": "81201",
16           "psa_count": 2,
17           "sanctioned": false,
18           "closed": false,
19           "translated_label": "Bank Of China Limited",
20           "company_type": "上榜投资机构",
21           "registration_date": "Registered 2015-08-18",
22           "latest_status": {
23             "status": "active",
24             "date": "2019-05-20"
25           },
26           "trade_count": {
27             "sent": 1,
28             "received": 1806
29           },
30           "type": "company",
31           "identifiers": [
32             {
33               "value": "54930053HGCFWVHYZX42",
34               "type": "lei",
35               "label": "Lei"
36             },
37             {
38               "value": "0001378999",
39               "type": "usa_sec_cik_number",
40               "label": "Usa Sec Cik Number"
41             },
42             {
43               "value": "03988",
44               "type": "hkg_stock_code",
45               "label": "Hkg Stock Code"
46             },
47             {
48               "value": "92751",
49               "type": "xxx_edi_global_issuer_id",
50               "label": "Xxx Edi Global Issuer Id"
51             },
52             {
53               "value": "C320201",
54               "type": "xxx_acuris_id",
55               "label": "Xxx Acuris Id"
56             }
57           ],
58           "addresses": [
59             "No. 1 Fuxingmen Nei Dajie, Beijing 100818, China",
60             "CHN",
61             "No. 1 Fuxingmen Nei Dajie, Beijing 100818, China China"
62           ],
63           "countries": [
64             "USA",
65             "JPN",
66             "CHN",
67             "FRA",
68             "PHL",
69             "HKG",
70             "KOR",
71             "NZL",
72             "GBR",
73             "LKA"
74           ],
75           "relationship_count": {
76             "receiver_of": 1806,
77             "linked_to": 68,
78             "branch_of": 161,
79             "has_branch": 11624,
80             "beneficial_owner_of": 1,
81             "has_beneficial_owner": 3,
82             "party_to": 1,
83             "has_officer": 35,
84             "has_manager": 21,
85             "shareholder_of": 289,
86             "has_shareholder": 244,
87             "notify_party_of": 2,
88             "shipper_of": 1,
89             "has_director": 187,
90             "has_member_of_the_board": 17,
91             "has_supervisor": 34,
92             "owner_of": 1443,
93             "ships_to": 1,
94             "receives_from": 114,
95             "has_subsidiary": 103,
96             "has_legal_representative": 12,
97             "issuer_of": 6350
98           },
99           "source_count": {
100             "eb361ba33d05a9d15b2d28aea739362a": {
101               "count": 11,
102               "label": "USA SEC Central Index Key Database"
103             },
104             "2b618f1996252fe537a6d998ae14c9b2": {
105               "count": 1,
106               "label": "UK Corporate Registry Confirmation Statements"
107             },
108             "a8c6ee1cd4dfc952105ee8c0e4836f08": {
109               "count": 151,
110               "label": "Acuris Risk Intelligence KYC6 (3rd Party Data)"
111             },
112             "1fbdc8f3abdf32274f4c7657c048294a": {
113               "count": 4,
114               "label": "China CNinfo Shanghai/Shenzhen Stock Exchange Database"
115             },
116             "e458b3b7bc1392d0723f6aa5a9fe4df1": {
117               "count": 5,
118               "label": "Japan METI gBizINFO Database"
119             },
120             "fcfa3d1c6b5f9744188fc01d0999fb76": {
121               "count": 405,
122               "label": "China SAIC"
123             },
124             "bf68c3a9a482c02f1f76342feb79af8d": {
125               "count": 1,
126               "label": "China Company Directory (Xin Gongshang Minglu)(Web Crawled Data)"
127             },
128             "a025b3503797a9cd1e1964dec6943594": {
129               "count": 3054,
130               "label": "Hong Kong Stock Exchange - Shareholding Disclosures"
131             },
132             "e0a238bcfc2f81ed9e5f345c0c7068f7": {
133               "count": 6,
134               "label": "USA Department of Labor Form 5500 Filings Database"
135             },
136             "5789a1459548517db4d61679a507be1a": {
137               "count": 1549,
138               "label": "USA SEC Securities Issuers"
139             },
140             "78586b6984ecb00e81563ae3d31c9227": {
141               "count": 1,
142               "label": "Myanmar DICA"
143             },
144             "9615bab28dddcc89548c928ab192ee7c": {
145               "count": 3,
146               "label": "Sri Lanka Imports & Exports (January 2023 - Present)"
147             },
148             "be720fea19724defd6aa652dfd5c35ed": {
149               "count": 1,
150               "label": "China Company Directory (Lanjing Zhengxin) (Web Crawled Data)"
151             },
152             "e85d865943ee6d8369307569d2ad9de0": {
153               "count": 68,
154               "label": "Acuris Risk Intelligence Adverse Media Data"
155             },
156             "b6382672c6741fe1bca28d2668c1732b": {
157               "count": 216,
158               "label": "China LHNB MOFCOM Foreign Investment Directory"
159             },
160             "48c4f3b0f7fcc732c9d075893ad004d2": {
161               "count": 10,
162               "label": "Hong Kong Stock Exchange - Listed Company Directors"
163             },
164             "db3416894cd5f0c4d2d6ecc79bdaf366": {
165               "count": 1065,
166               "label": "EDI Publicly-Listed Global Security Issuers (3rd Party Data)"
167             },
168             "faa9caafcfabcee04ef2f0b21dd9197a": {
169               "count": 155,
170               "label": "South Korea Imports & Exports (2021 - Present)"
171             },
172             "b812677c0a32a1746b3ac741c7b97ae0": {
173               "count": 71620,
174               "label": "Legal Entity Identifier (LEI) Registry (3rd Party Data)"
175             },
176             "0ff02c63234d4447c803acd7748b9afc": {
177               "count": 28,
178               "label": "China Company Directory (Shuidi)(Web Crawled Data)"
179             },
180             "de2a65257042beae5373354223cbd55b": {
181               "count": 3,
182               "label": "Japan Houjin National Tax Agency Corporation Number Publication Site"
183             },
184             "2cd05c04774a433ce4d79e61ee105d08": {
185               "count": 9,
186               "label": "Hong Kong Judiciary Judgments"
187             },
188             "ce462e9deea545cce35df38c48512a0c": {
189               "count": 1636,
190               "label": "India Imports & Exports (January 2023 - Present)"
191             },
192             "8de630b7a702183da138321ae0f1c4b0": {
193               "count": 1,
194               "label": "China Imports & Exports (2022 - Present)"
195             },
196             "ecdfb3f2ecc8c3797e77d5795a8066ef": {
197               "count": 5,
198               "label": "UK Corporate Registry"
199             },
200             "eaa2c4801c4acde073decdfae533bd0e": {
201               "count": 4,
202               "label": "France BODACC"
203             },
204             "8f50655ba1d1552ab4b89d119bd9c318": {
205               "count": 3822,
206               "label": "China Trademarks & Intellectual Property System"
207             },
208             "441b8bd29977208d312f2192675b05d9": {
209               "count": 1,
210               "label": "China Company Directory (Shunqiwang) (Web Crawled Data)"
211             },
212             "0cf0044442daf17258e27a6ddd49770f": {
213               "count": 225,
214               "label": "China NECIPS"
215             },
216             "93f0d99bcf2cc0b9f09cacc92640e54c": {
217               "count": 1,
218               "label": "Zimbabwe Imports & Exports (January 2023 - June 2023)"
219             },
220             "ddbf93a5c5d568ccdb0c2455f7ecbfc8": {
221               "count": 9,
222               "label": "USA CorpWatch SEC 10-K Exhibit 21 Database (3rd Party Data)"
223             },
224             "148946e7e3e5b2ba031bfcefa28e4d83": {
225               "count": 33,
226               "label": "China Company Directory (Aiqicha)(Web Crawled Data)"
227             },
228             "e85f886caf11a16c40512647def393e0": {
229               "count": 20,
230               "label": "New Zealand Corporate Registry"
231             },
232             "16a4cc2d0f467fa993b28587d542a25d": {
233               "count": 11,
234               "label": "USA Imports (2021 - Present)"
235             },
236             "546a239179eb5ba24177e29e308005bf": {
237               "count": 2,
238               "label": "Pakistan Imports (2011-2021)"
239             },
240             "7e0b45866bdcca61b2cfd455e5403dc2": {
241               "count": 9,
242               "label": "China Central Government Procurement Center Enterprise Database"
243             },
244             "b67ab545f3ddc960d272d11ec5952665": {
245               "count": 6,
246               "label": "France Sirene/Infogreffe Commercial Registries"
247             },
248             "74cf0fc2a62f9c8f4e88f8a0b3ffcca4": {
249               "count": 2,
250               "label": "Hong Kong Companies Registry"
251             },
252             "4ea8bac1bed868e1510ffd21842e9551": {
253               "count": 39,
254               "label": "UK Persons with Significant Control"
255             },
256             "8f21460f1cc54773b9672cb5efdb01cf": {
257               "count": 7,
258               "label": "China Ministry of Finance Government Procurement Announcements"
259             }
260           },
261           "risk": {
262             "regulatory_action": {
263               "value": true,
264               "metadata": {},
265               "level": "high"
266             },
267             "eu_high_risk_third": {
268               "value": true,
269               "metadata": {
270                 "country": [
271                   "PHL",
272                   "AFG"
273                 ]
274               },
275               "level": "relevant"
276             },
277             "reputational_risk_financial_crime": {
278               "value": true,
279               "metadata": {},
280               "level": "elevated"
281             },
282             "owner_of_sanctioned_entity": {
283               "value": 3,
284               "metadata": {},
285               "level": "high"
286             },
287             "basel_aml": {
288               "value": 8.45,
289               "metadata": {
290                 "country": [
291                   "AFG"
292                 ]
293               },
294               "level": "relevant"
295             },
296             "state_owned": {
297               "value": true,
298               "metadata": {},
299               "level": "high"
300             },
301             "owner_of_export_controls_entity": {
302               "value": 3,
303               "metadata": {},
304               "level": "high"
305             },
306             "meu_list_contractors": {
307               "value": true,
308               "metadata": {
309                 "sources": [
310                   "China Central Government Procurement Center Enterprise Database",
311                   "China Ministry of Finance Government Procurement Announcements"
312                 ]
313               },
314               "level": "high"
315             },
316             "reputational_risk_other": {
317               "value": true,
318               "metadata": {},
319               "level": "elevated"
320             },
321             "owner_of_sheffield_hallam_university_reports_forced_labor_entity": {
322               "value": 3,
323               "metadata": {},
324               "level": "high"
325             },
326             "cpi_score": {
327               "value": 16,
328               "metadata": {
329                 "country": [
330                   "AFG"
331                 ]
332               },
333               "level": "relevant"
334             },
335             "pep_adjacent": {
336               "value": true,
337               "metadata": {},
338               "level": "elevated"
339             },
340             "owner_of_forced_labor_xinjiang_entity": {
341               "value": 1,
342               "metadata": {},
343               "level": "high"
344             },
345             "law_enforcement_action": {
346               "value": true,
347               "metadata": {},
348               "level": "elevated"
349             }
350           },
351           "user_attribute_counts": {},
352           "user_attribute_count": {},
353           "user_record_count": 0,
354           "user_related_entities_count": 0,
355           "user_relationship_count": {},
356           "related_entities_count": 22179,
357           "attribute_counts": {
358             "company_type": 20,
359             "name": 25,
360             "business_purpose": 41,
361             "identifier": 33,
362             "additional_information": 29,
363             "country": 35,
364             "contact": 49,
365             "shares": 11,
366             "status": 6,
367             "address": 91,
368             "financials": 7
369           },
370           "attribute_count": {
371             "company_type": 20,
372             "name": 25,
373             "business_purpose": 41,
374             "identifier": 33,
375             "additional_information": 29,
376             "country": 35,
377             "contact": 49,
378             "shares": 11,
379             "status": 6,
380             "address": 91,
381             "financials": 7
382           },
383           "reference_id": "bc5bfbbd56e094337aa743fa721a48cc/firm_fffe1851b4a2a8c09c822409757dd675.html/1553604848901:20b21074f749bb4124997622fe6f3808"
384         },
385         "type": "about"
386       }
387     ],
388     "limit": 100,
389     "next": false,
390     "offset": 0,
391     "size": {
392       "count": 1,
393       "qualifier": "eq"
394     }
395   },
396   "references_count": 1,
397   "source": "74cf0fc2a62f9c8f4e88f8a0b3ffcca4",
398   "document_urls": [
399     "/document/74cf0fc2a62f9c8f4e88f8a0b3ffcca4%2FF0000110%2F1682970471254/file/json%2FF0000110.json"
400   ],
401   "publication_date": "2023-05-01",
402   "source_url": "https://data.gov.hk/en-data/dataset/hk-cr-crdata-list-addr"
403 }

Retrieve a record from the database based on the ID

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

idstringRequired

The unique identifier for a record in the database

Query parameters

references.limitintegerOptional

A limit on the number of references to be returned. Defaults to 100.

references.offsetintegerOptional

Number of references to skip before returning response. Defaults to 0.

Response

This endpoint returns an object.

acquisition_datestring

The date Sayari acquired this record

idstring

The unique identifier for a record in the database

labelstring

record_urlstring

The url to download the record from Sayari

referencesobject

references_countinteger

Number of times this record is referenced

sourcestring

The unique identifier for a source in the database

countryenum

Country enums are normalized representations of country names. Source

Country enums are normalized representations of country names. [Source](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#ECU)

document_urlslist of strings

matchesmap from strings to lists of strings

pagedouble

page_countdouble

publication_datestring

The date the record was published

source_urlstring

The url to access to original source

Errors

400

Bad Request

401

Unauthorized

404

Not Found

405

Method Not Allowed

429

Rate Limit Exceeded

500

Internal Server Error