Get Project Entity Risk Summary

Beta

GET

/v1/projects/:project_id/entities/:project_entity_id/risk_summary

GET

/v1/projects/:project_id/entities/:project_entity_id/risk_summary

1 curl -G https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary \
2      -H "Authorization: Bearer <token>" \
3      -d "filter[risk_factor]=sanctioned" \
4      -d "filter[risk_factor]=regulatory_action" \
5      -d "filter[risk_category]=sanctions" \
6      -d "filter[risk_category]=export_controls"

1 {
2   "data": {
3     "project_entity_id": "GleDrP",
4     "project_id": "8YMJNG",
5     "risk_factors": [
6       {
7         "id": "imports_ilab_child_labor",
8         "label": "Imports Goods with ILAB Child Labor Risk",
9         "value": "true",
10         "level": "elevated",
11         "risk_categories": [
12           {
13             "id": "forced_labor",
14             "label": "Forced labor",
15             "risk_factors": [
16               "imports_ilab_child_labor"
17             ]
18           }
19         ],
20         "source_entity_ids": [
21           "FFgmjk4bK6vDn25yMypciw"
22         ],
23         "network_paths": [
24           []
25         ],
26         "metadata": [
27           {
28             "traversal_path": [
29               "FFgmjk4bK6vDn25yMypciw|receiver_of|QB7r598_7sPrCNefvZrAyw"
30             ],
31             "origin_shipment_product": [
32               "640299",
33               "5705",
34               "62",
35               "5702",
36               "64",
37               "42"
38             ]
39           }
40         ],
41         "risk_intelligence": [
42           {
43             "type": "financial_risk_score",
44             "score": 36,
45             "Label": "S&P RiskGauge Credit Risk"
46           }
47         ]
48       },
49       {
50         "id": "forced_labor_xinjiang_origin_subtier",
51         "label": "Supplier Network with Xinjiang-Based Entity",
52         "value": 2,
53         "level": "elevated",
54         "risk_categories": [
55           {
56             "id": "forced_labor",
57             "label": "Forced labor",
58             "risk_factors": [
59               "forced_labor_xinjiang_origin_subtier"
60             ]
61           }
62         ],
63         "source_entity_ids": [
64           "FFgmjk4bK6vDn25yMypciw"
65         ],
66         "network_paths": [
67           [
68             {
69               "sayari_entity_id": "doWJaXqr57DBYPyHcF_BxQ",
70               "sayari_entity_label": "LIBERTY MILLS LIMITED",
71               "relationship_type": "receives_from",
72               "relationship_status": "active",
73               "former": false,
74               "first_observed": "2024-03-08",
75               "last_observed": "2024-03-14",
76               "start_date": "2024-03-08",
77               "shares": {}
78             },
79             {
80               "sayari_entity_id": "A3YwnnynaDQnlinlbt-UlQ",
81               "sayari_entity_label": "XINXIANG CHEMICAL FIBRE CO., LTD",
82               "relationship_type": "receives_from",
83               "relationship_status": "active",
84               "former": false,
85               "first_observed": "2024-03-11",
86               "last_observed": "2024-03-25",
87               "start_date": "2024-03-11",
88               "shares": {}
89             }
90           ]
91         ],
92         "metadata": [
93           {
94             "traversal_path": [
95               "FFgmjk4bK6vDn25yMypciw|receives_from|doWJaXqr57DBYPyHcF_BxQ|receives_from|A3YwnnynaDQnlinlbt-UlQ"
96             ]
97           }
98         ],
99         "risk_intelligence": [
100           {
101             "type": "financial_risk_score",
102             "score": 36,
103             "Label": "S&P RiskGauge Credit Risk"
104           }
105         ]
106       },
107       {
108         "id": "forced_labor_sheffield_hallam_university_reports_origin_subtier",
109         "label": "Supplier Network with Entity from Sheffield Hallam University Forced Labor Reports",
110         "value": 2,
111         "level": "elevated",
112         "risk_categories": [
113           {
114             "id": "forced_labor",
115             "label": "Forced labor",
116             "risk_factors": [
117               "forced_labor_sheffield_hallam_university_reports_origin_subtier"
118             ]
119           }
120         ],
121         "source_entity_ids": [
122           "FFgmjk4bK6vDn25yMypciw"
123         ],
124         "network_paths": [
125           [
126             {
127               "sayari_entity_id": "hky4niXTOuJOZ3YJUHBvpw",
128               "sayari_entity_label": "KOHINOOR TEXTILE MILLS LIMITED",
129               "relationship_type": "receives_from",
130               "relationship_status": "active",
131               "former": false,
132               "first_observed": "2023-09-27",
133               "last_observed": "2023-09-27",
134               "start_date": "2023-09-27",
135               "shares": {}
136             },
137             {
138               "sayari_entity_id": "jcG2-gcTVXhH6J2UO7bASg",
139               "sayari_entity_label": "WEIQIAO TEXTILE COMPANY LIMITED",
140               "relationship_type": "receives_from",
141               "relationship_status": "active",
142               "former": false,
143               "first_observed": "2017-03-08",
144               "last_observed": "2025-04-21",
145               "start_date": "2017-03-08",
146               "shares": {}
147             }
148           ]
149         ],
150         "metadata": [
151           {
152             "traversal_path": [
153               "FFgmjk4bK6vDn25yMypciw|receives_from|hky4niXTOuJOZ3YJUHBvpw|receives_from|jcG2-gcTVXhH6J2UO7bASg"
154             ]
155           }
156         ],
157         "risk_intelligence": [
158           {
159             "type": "financial_risk_score",
160             "score": 36,
161             "Label": "S&P RiskGauge Credit Risk"
162           }
163         ]
164       },
165       {
166         "id": "forced_labor_uflpa_origin_subtier",
167         "label": "Supplier Network with UFLPA Entity",
168         "value": 3,
169         "level": "elevated",
170         "risk_categories": [
171           {
172             "id": "forced_labor",
173             "label": "Forced labor",
174             "risk_factors": [
175               "forced_labor_uflpa_origin_subtier"
176             ]
177           }
178         ],
179         "source_entity_ids": [
180           "FFgmjk4bK6vDn25yMypciw"
181         ],
182         "network_paths": [
183           [
184             {
185               "sayari_entity_id": "Lg1BHckRWGrKUT03LUy3iw",
186               "sayari_entity_label": "KAMAL LIMITED",
187               "relationship_type": "receives_from",
188               "relationship_status": "active",
189               "former": false,
190               "first_observed": "2024-04-29",
191               "last_observed": "2025-04-21",
192               "start_date": "2024-04-29",
193               "shares": {}
194             },
195             {
196               "sayari_entity_id": "rmgKmpNeQxhVNnrnemI2yQ",
197               "sayari_entity_label": "CôNG TY TRáCH NHIệM HữU HạN HYOSUNG ĐồNG NAI",
198               "relationship_type": "receives_from",
199               "relationship_status": "active",
200               "former": false,
201               "first_observed": "2023-09-28",
202               "last_observed": "2025-04-13",
203               "start_date": "2023-09-28",
204               "shares": {}
205             },
206             {
207               "sayari_entity_id": "CZAZypVNS-jkOGzpRpCXEw",
208               "sayari_entity_label": "HANGZHOU UNION BIOTECHNOLOGY CO., LTD",
209               "relationship_type": "receives_from",
210               "relationship_status": "active",
211               "former": false,
212               "first_observed": "2023-03-09",
213               "last_observed": "2025-02-27",
214               "start_date": "2023-03-09",
215               "shares": {}
216             }
217           ]
218         ],
219         "metadata": [
220           {
221             "traversal_path": [
222               "FFgmjk4bK6vDn25yMypciw|receives_from|Lg1BHckRWGrKUT03LUy3iw|receives_from|rmgKmpNeQxhVNnrnemI2yQ|receives_from|CZAZypVNS-jkOGzpRpCXEw"
223             ]
224           }
225         ],
226         "risk_intelligence": [
227           {
228             "type": "financial_risk_score",
229             "score": 36,
230             "Label": "S&P RiskGauge Credit Risk"
231           }
232         ]
233       }
234     ]
235   },
236   "filters": {
237     "risk_factor": [
238       "imports_ilab_child_labor",
239       "forced_labor_xinjiang_origin_subtier"
240     ],
241     "risk_category": [
242       "forced_labor"
243     ]
244   }
245 }

Retrieves a risk summary for a specific project entity, including risk factors with network paths and risk intelligence data.

Response includes:

Risk factors with their levels (elevated, high, critical)
Network paths showing relationships between entities
Risk intelligence scores and metadata
Risk categories and source entity information

Retrieves a risk summary for a specific project entity, including risk factors with network paths and risk intelligence data. **Response includes:** - Risk factors with their levels (elevated, high, critical) - Network paths showing relationships between entities - Risk intelligence scores and metadata - Risk categories and source entity information

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

project_idstringRequired

project_entity_idstringRequired

Query parameters

filterobjectRequired

Filter risk factors by risk factor IDs and risk categories

Response

This endpoint returns an object.

dataobject

filtersobject

Errors

400

Bad Request

401

Unauthorized

404

Not Found

405

Method Not Allowed

429

Rate Limit Exceeded

500

Internal Server Error