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
      • POSTCreate Project Entity
      • GETGet Project Entities
      • GETGet Project Entity
      • POSTAdd Project Entity Matches
      • PATCHReplace Project Entity Matches
      • DELDelete Project Entity
      • DELDelete Project Entity Match
      • POSTProject Entity Exists
      • POSTSave Project Entity
      • GETGet Project Risk Changes
      • GETGet Project Entity Risk Changes
      • DELDelete Project Risk Changes
      • DELDelete Project Entity Risk Changes
      • GETProject Entity Supply Chain
      • GETGet Project Entity Risk Summary
      • GETProject Entity Supply Chain Summary
  • 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 ReferenceProject Entity

Get Project Entities

Beta
GET
/v1/projects/:project_id/entities
GET
/v1/projects/:project_id/entities
$curl https://api.sayari.com/v1/projects/YVB88Y/entities \
> -H "Authorization: Bearer <token>"
1{
2 "limit": 20,
3 "data": [
4 {
5 "project_entity_id": "52z4Wa",
6 "project_id": "YVB88Y",
7 "label": "VTB Bank",
8 "upload_ids": [],
9 "strength": "strong",
10 "created_at": "2025-04-22 22:54:00.913586+00",
11 "attributes": {
12 "name": {
13 "match_resolution": true,
14 "values": [
15 "VTB Bank"
16 ]
17 },
18 "country": {
19 "match_resolution": true,
20 "values": [
21 "RUS"
22 ]
23 },
24 "address": {
25 "match_resolution": true,
26 "values": [
27 "Moscow"
28 ]
29 },
30 "identifier": {
31 "match_resolution": true,
32 "values": [
33 "253400V1H6ART1UQ0N98"
34 ]
35 }
36 },
37 "countries": [
38 "USA",
39 "CYP",
40 "ITA",
41 "CHN",
42 "RUS",
43 "UKR",
44 "IND",
45 "IRL",
46 "KAZ",
47 "DEU"
48 ],
49 "risk_categories": [
50 {
51 "id": "regulatory_action",
52 "label": "Regulatory action",
53 "risk_factors": [
54 "regulatory_action"
55 ]
56 },
57 {
58 "id": "export_controls",
59 "label": "Export controls",
60 "risk_factors": [
61 "meu_list_contractors",
62 "export_controls"
63 ]
64 },
65 {
66 "id": "political_exposure",
67 "label": "Political exposure",
68 "risk_factors": [
69 "soe_adjacent",
70 "pep_adjacent"
71 ]
72 },
73 {
74 "id": "sanctions",
75 "label": "Sanctions",
76 "risk_factors": [
77 "sanctioned",
78 "formerly_sanctioned"
79 ]
80 },
81 {
82 "id": "adverse_media",
83 "label": "Adverse media",
84 "risk_factors": [
85 "reputational_risk_other"
86 ]
87 }
88 ],
89 "risk_factors": [
90 {
91 "id": "regulatory_action"
92 },
93 {
94 "id": "sanctioned"
95 },
96 {
97 "id": "meu_list_contractors"
98 },
99 {
100 "id": "reputational_risk_other"
101 },
102 {
103 "id": "pep_adjacent"
104 },
105 {
106 "id": "state_owned"
107 },
108 {
109 "id": "export_controls"
110 },
111 {
112 "id": "formerly_sanctioned"
113 },
114 {
115 "id": "basel_aml"
116 },
117 {
118 "id": "cpi_score"
119 }
120 ],
121 "upstream": {
122 "risk_factors": [],
123 "countries": [],
124 "trade_counts": {
125 "receiver_of": 2,
126 "shipper_of": 56
127 },
128 "has_upstream": false,
129 "products": []
130 },
131 "tags": [],
132 "matches": [
133 {
134 "match_id": "52z4Wa:dy-rh2g0QtzUN_jC_e9S_A",
135 "sayari_entity_id": "dy-rh2g0QtzUN_jC_e9S_A",
136 "type": "company",
137 "label": "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"РОССИЙСКИЕ ЖЕЛЕЗНЫЕ ДОРОГИ\"",
138 "countries": [
139 "USA",
140 "CYP",
141 "ITA",
142 "CHN",
143 "RUS",
144 "UKR",
145 "IND",
146 "IRL",
147 "KAZ",
148 "DEU"
149 ],
150 "risk_categories": [
151 {
152 "id": "regulatory_action",
153 "label": "Regulatory action",
154 "risk_factors": [
155 "regulatory_action"
156 ]
157 },
158 {
159 "id": "export_controls",
160 "label": "Export controls",
161 "risk_factors": [
162 "meu_list_contractors",
163 "export_controls"
164 ]
165 },
166 {
167 "id": "political_exposure",
168 "label": "Political exposure",
169 "risk_factors": [
170 "soe_adjacent",
171 "pep_adjacent"
172 ]
173 },
174 {
175 "id": "sanctions",
176 "label": "Sanctions",
177 "risk_factors": [
178 "sanctioned",
179 "formerly_sanctioned"
180 ]
181 },
182 {
183 "id": "adverse_media",
184 "label": "Adverse media",
185 "risk_factors": [
186 "reputational_risk_other"
187 ]
188 }
189 ],
190 "risk_factors": [
191 {
192 "id": "regulatory_action"
193 },
194 {
195 "id": "sanctioned"
196 },
197 {
198 "id": "meu_list_contractors"
199 },
200 {
201 "id": "reputational_risk_other"
202 },
203 {
204 "id": "pep_adjacent"
205 },
206 {
207 "id": "state_owned"
208 },
209 {
210 "id": "export_controls"
211 },
212 {
213 "id": "formerly_sanctioned"
214 },
215 {
216 "id": "basel_aml"
217 },
218 {
219 "id": "cpi_score"
220 }
221 ],
222 "business_purpose": [
223 {
224 "code": "6419",
225 "standard": "ISIC4"
226 },
227 {
228 "code": "64.19",
229 "standard": "unknown"
230 },
231 {
232 "code": "64.9",
233 "standard": "unknown"
234 },
235 {
236 "code": "62.09",
237 "standard": "unknown"
238 },
239 {
240 "code": "64.19",
241 "standard": "NACE2"
242 },
243 {
244 "code": "64.19",
245 "standard": "unknown"
246 },
247 {
248 "code": "649",
249 "standard": "ISIC4"
250 },
251 {
252 "code": "66.12",
253 "standard": "unknown"
254 },
255 {
256 "code": "6419",
257 "standard": "ISIC4"
258 },
259 {
260 "code": "6209",
261 "standard": "ISIC4"
262 },
263 {
264 "code": "6612",
265 "standard": "ISIC4"
266 }
267 ],
268 "upstream": {
269 "risk_factors": [],
270 "countries": [],
271 "trade_counts": {
272 "receiver_of": 2,
273 "shipper_of": 56
274 },
275 "has_upstream": false,
276 "products": []
277 },
278 "sources": [
279 {
280 "id": "eb361ba33d05a9d15b2d28aea739362a",
281 "label": "USA SEC Central Index Key Database"
282 },
283 {
284 "id": "a8c6ee1cd4dfc952105ee8c0e4836f08",
285 "label": "Acuris Risk Intelligence KYC6 (3rd Party Data)"
286 },
287 {
288 "id": "3322a755c28851ec06eda3280cc2a2b2",
289 "label": "Russia ClearSpending (3rd Party Data)"
290 },
291 {
292 "id": "93de05b55a68cc964f34bbfc7ec7bc86",
293 "label": "Consolidated Canadian Autonomous Sanctions List"
294 },
295 {
296 "id": "fdfedf11a5122e2aef9dc3f176c7427d",
297 "label": "Sayari Intel (Sayari Curated Risk Data) - Archived"
298 },
299 {
300 "id": "e517c714b560f159a89a9501ed7dd84e",
301 "label": "Infocredit Cyprus Company Shareholders Database (3rd Party Data)"
302 },
303 {
304 "id": "bef2f30139ea37c723ecb0f953b5f024",
305 "label": "Australia Consolidated Sanctions List"
306 },
307 {
308 "id": "9048153c770d941afe9500c6ad810a80",
309 "label": "Kazakhstan DFO Registry"
310 },
311 {
312 "id": "635021e4e01979cdf95fa7ee76501696",
313 "label": "Russia E-Disclosures"
314 },
315 {
316 "id": "e85d865943ee6d8369307569d2ad9de0",
317 "label": "Acuris Risk Intelligence Adverse Media Data"
318 },
319 {
320 "id": "4ff85397f508e4ff8e71c5ca5ea895dd",
321 "label": "Japan Ministry of Finance Economic Sanctions List"
322 },
323 {
324 "id": "ce873f184abee5b13c9e89791bd78229",
325 "label": "Ukraine Significant Shareholders of Securities Issuers"
326 },
327 {
328 "id": "8511f57f6098dcc36e3a814c3ea5bdd7",
329 "label": "Uzbekistan Imports & Exports (January 2022 - Present)"
330 },
331 {
332 "id": "e6e4acebdea4e9e71af8d3586d34fcdd",
333 "label": "Ukraine Sanctions List"
334 },
335 {
336 "id": "db3416894cd5f0c4d2d6ecc79bdaf366",
337 "label": "EDI Publicly-Listed Global Security Issuers (3rd Party Data)"
338 },
339 {
340 "id": "b812677c0a32a1746b3ac741c7b97ae0",
341 "label": "Legal Entity Identifier (LEI) Registry (3rd Party Data)"
342 },
343 {
344 "id": "a9a18eeb901e4376c912e95dc05ceb78",
345 "label": "Russia Federal Tax Registry"
346 },
347 {
348 "id": "d357238101a2bb02d97d5d77a56d9455",
349 "label": "New Zealand Russia Sanctions"
350 },
351 {
352 "id": "f4ce10ac8bdc0bd9bcb31cb868b4b539",
353 "label": "EU Financial Sanctions List"
354 },
355 {
356 "id": "c10d482320f207d92aa814519c3bd686",
357 "label": "UK Consolidated Sanctions List"
358 },
359 {
360 "id": "d1bce737c158efddbef5048d63aaf124",
361 "label": "Ukraine Ministry of Justice Registry of Companies"
362 },
363 {
364 "id": "92edb8fe6615498f6e3e7b0e220f74e6",
365 "label": "USA Treasury OFAC Specially Designated Nationals (SDN) List"
366 },
367 {
368 "id": "66dfefb726ae00fde8f09f34c5578d35",
369 "label": "Russia Imports & Exports (January 2023 - Present)"
370 },
371 {
372 "id": "ad6dc774c74b92159422deabc5aee661",
373 "label": "France National Asset Freeze Register"
374 },
375 {
376 "id": "b97ad5c858093e5227b2359a0078696f",
377 "label": "USA SAM.gov Entity Exclusions Database"
378 },
379 {
380 "id": "ddbf93a5c5d568ccdb0c2455f7ecbfc8",
381 "label": "USA CorpWatch SEC 10-K Exhibit 21 Database (3rd Party Data)"
382 },
383 {
384 "id": "52a7bc4a30e787544ad2d95e7f54adca",
385 "label": "USA OFAC Non-SDN Consolidated Sanctions List"
386 },
387 {
388 "id": "f43658cf2a19452fb45b830edeeeea44",
389 "label": "Russia Central Bank Financial Institution UBO Disclosures"
390 },
391 {
392 "id": "828f81c7c31410de845d9e6ed1a0f3e6",
393 "label": "Russia Central Bank Financial Institutions"
394 },
395 {
396 "id": "56bce0e008204712e302271ddd7b4fb1",
397 "label": "Russia Federal Tax Registry (2018)"
398 },
399 {
400 "id": "e0b32f41da3b4e6c75f1f7bf6fe1c9c5",
401 "label": "S&P Global Market Intelligence Database (3rd Party Data)"
402 },
403 {
404 "id": "10a889609ddae6cc31773feebe48166b",
405 "label": "Switzerland SECO Sanctions List"
406 },
407 {
408 "id": "ded706ef28cdc649b6fc5142bc542890",
409 "label": "EU Sanctions Map"
410 },
411 {
412 "id": "417400a1ac439843fda5bb2f05fb4161",
413 "label": "USA Consolidated Screening List"
414 },
415 {
416 "id": "765d0dc816bb7db35031c43a37290350",
417 "label": "Ireland Companies Registration Office Database"
418 }
419 ],
420 "addresses": [
421 {
422 "value": "190000, г Санкт-Петербург, ул Большая Морская, дом 29"
423 },
424 {
425 "value": "109147 г. Москва, ул. Воронцовская, д.43 стр.1"
426 },
427 {
428 "value": "119121 г. Москва, ул. Плющиха, д. 37."
429 },
430 {
431 "value": "43, Vorontsovskaya str., Moscow, 109044, Russia"
432 },
433 {
434 "value": "11, lit A, Degtyarnyy pereulok, St. Petersburg, 191144, Russia"
435 },
436 {
437 "value": "29, Bolshaya Morskaya str., St. Petersburg, 190000, Russia"
438 }
439 ],
440 "hs_codes": [
441 "847150",
442 "8471500000",
443 "852351",
444 "8523519101",
445 "860610",
446 "8606100000",
447 "271019",
448 "2710196601",
449 "490700",
450 "4907003000",
451 "711890",
452 "7118900000",
453 "490700",
454 "4907003000",
455 "711890",
456 "7118900000"
457 ],
458 "created_at": "2025-04-22 22:54:00.913586+00",
459 "updated_at": "2025-04-22 22:54:00.913586+00",
460 "match_explanation": [
461 {
462 "field": "name",
463 "quality": "high",
464 "matches": [
465 "<em>БАНК</em> <em>ВТБ</em> (ПАО)",
466 "<em>VTB</em> <em>BANK</em> (PJSC)",
467 "<em>БАНК</em> <em>ВТБ</em> (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)",
468 "<em>VTB</em> <em>BANK</em> (PUBLIC JOINT STOCK COMPANY)",
469 "<em>VTB</em> <em>Bank</em>"
470 ]
471 },
472 {
473 "field": "address",
474 "quality": "medium",
475 "matches": [
476 "109147 <em>Moscow</em>, st. Vorontsovskaya, 43 building 1",
477 "119121 <em>Moscow</em>, st. Plyushchikha, 37.",
478 "Vorontsovskaya Str., 43 <em>Moscow</em> 109044 RUSSIAN FEDERATION",
479 "37 Plyushchikha ul., <em>Moscow</em>, 119121, Russia",
480 "Bashnya Zapad, Kompleks Federatsiya, 12, nab. Presnenskaya, <em>Moscow</em>, 123317, Russia"
481 ]
482 },
483 {
484 "field": "country",
485 "quality": "high",
486 "matches": [
487 "<em>RUS</em>"
488 ]
489 },
490 {
491 "field": "identifier",
492 "quality": "high",
493 "matches": [
494 "<em>253400V1H6ART1UQ0N98</em>"
495 ]
496 }
497 ]
498 }
499 ],
500 "case": {
501 "id": "YZB88Y",
502 "status": "not_assigned",
503 "created_at": "2025-10-02"
504 },
505 "updated_at": "2025-04-23 13:37:00.215522+00",
506 "updated_by": "auth0|5e45bd8caccd890e68147513"
507 }
508 ],
509 "size": {
510 "count": 1,
511 "qualifier": "eq"
512 }
513}
Retrieves a list of entities for a specific project with pagination support. **Response Formats:** - **JSON** (default): Returns structured data with nested objects - **CSV**: Returns tabular data with dynamic columns for attributes and risk categories **CSV Format:** The CSV response includes dynamic columns based on the data: - `attribute_{field_name}`: Dynamic columns for each attribute field found in the data - `risk_category_{category_id}`: Dynamic columns for each risk category found in the data - Standard columns: project_id, project_entity_id, label, project_entity_url, upload_ids, strength, countries, tags, case_status, created_at, match_count, upstream_products, upstream_risk_factors, upstream_countries Use the `Accept: text/csv` header to request CSV format.
Was this page helpful?
Previous

Get Project Entity

Next
Built with

Retrieves a list of entities for a specific project with pagination support.

Response Formats:

  • JSON (default): Returns structured data with nested objects
  • CSV: Returns tabular data with dynamic columns for attributes and risk categories

CSV Format: The CSV response includes dynamic columns based on the data:

  • attribute_{field_name}: Dynamic columns for each attribute field found in the data
  • risk_category_{category_id}: Dynamic columns for each risk category found in the data
  • Standard columns: project_id, project_entity_id, label, project_entity_url, upload_ids, strength, countries, tags, case_status, created_at, match_count, upstream_products, upstream_risk_factors, upstream_countries

Use the Accept: text/csv header to request CSV format.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

project_idstringRequired

Query parameters

nextstringOptional
The pagination token for the next page of projects.
prevstringOptional
The pagination token for the previous page of projects.
limitintegerOptional
Limit total values returned for projects. Defaults to 100. Max 100.
filterobjectOptional

Filter the project entities. Supports both dot notation (e.g., ‘filter.attribute.name’) and bracket notation (e.g., ‘filter[attribute][name]’) for nested field filtering.

Response

This endpoint returns an object.
limitinteger
datalist of objects
sizeobject
nextstring
prevstring

Errors

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