> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://documentation.sayari.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://documentation.sayari.com/_mcp/server. # Get Project Entity Risk Summary GET https://api.sayari.com/v1/projects/{project_id}/entities/{project_entity_id}/risk_summary 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 Reference: https://documentation.sayari.com/api/api-reference/project-entity/get-project-entity-risk-summary ## Authentication - OAuth2 — send the obtained token as `Authorization: Bearer ` ## Servers - `https://api.sayari.com` (Production, default) - `https://api.internal.sayari.com` (Dev) - `https://api.uk.sayari.com` (Production_UK) ## Request ### Path parameters - `project_id` (string, required) - `project_entity_id` (string, required) ### Query parameters - `filter` (ProjectEntityRiskSummaryFilters, required) — Filter risk factors by risk factor IDs and risk categories ## Response ### 200 - `data` (ProjectEntityRiskSummaryData, required) - `filters` (ProjectEntityRiskSummaryResponseFilters, required) ## Errors ### 400 Bad Request - `any` ### 401 Unauthorized - `any` ### 404 Not Found - `status` (integer, required) - `message` (list of string, required) - `success` (boolean, required) ### 405 Method Not Allowed - `status` (integer, required) - `message` (list of string, required) - `success` (boolean, required) ### 429 Rate Limit Exceeded - `any` ### 500 Internal Server Error - `any` ## Types ### ProjectEntityRiskSummaryFilters - `risk_factor` (list of string, optional) — Filter by risk factor IDs - `risk_category` (list of string, optional) — Filter by risk category IDs ### ProjectEntityRiskSummaryData - `project_entity_id` (string, required) - `project_id` (string, required) - `risk_factors` (list of ProjectEntityRiskSummaryRiskFactor, required) ### ProjectEntityRiskSummaryResponseFilters - `risk_factor` (list of string, optional) - `risk_category` (list of string, optional) ### ProjectEntityRiskSummaryRiskFactor - `id` (string, required) - `label` (string, required) - `value` (StringOrNumber, required) - `level` (enum, required) - Allowed values: `critical`, `high`, `elevated`, `relevant` - `risk_categories` (list of ProjectRiskCategory, required) - `source_entity_ids` (list of string, required) - `network_paths` (list of list of ProjectEntityRiskSummaryNetworkPath, required) - `metadata` (list of map from string to list of StringOrNumber, required) - `risk_intelligence` (list of map from string to StringOrNumber, required) ### StringOrNumber ### ProjectRiskCategory - `id` (string, required) - `label` (string, required) - `risk_factors` (list of string, required) ### ProjectEntityRiskSummaryNetworkPath - `sayari_entity_id` (string, required) - `sayari_entity_label` (string, required) - `relationship_type` (string, required) - `relationship_status` (string, required) - `former` (boolean, required) - `first_observed` (string, required) - `last_observed` (string, required) - `start_date` (string, optional) - `shares` (ShareInformation, optional) ### ShareInformation - `percentage` (double, optional) - `num_shares` (integer, optional) - `monetary_value` (integer, optional) ## Examples **Response** ```json { "data": { "project_entity_id": "GleDrP", "project_id": "8YMJNG", "risk_factors": [ { "id": "imports_ilab_child_labor", "label": "Imports Goods with ILAB Child Labor Risk", "value": "true", "level": "elevated", "risk_categories": [ { "id": "forced_labor", "label": "Forced labor", "risk_factors": [ "imports_ilab_child_labor" ] } ], "source_entity_ids": [ "FFgmjk4bK6vDn25yMypciw" ], "network_paths": [ [] ], "metadata": [ { "traversal_path": [ "FFgmjk4bK6vDn25yMypciw|receiver_of|QB7r598_7sPrCNefvZrAyw" ], "origin_shipment_product": [ "640299", "5705", "62", "5702", "64", "42" ] } ], "risk_intelligence": [ { "type": "financial_risk_score", "score": 36, "Label": "S&P RiskGauge Credit Risk" } ] }, { "id": "forced_labor_xinjiang_origin_subtier", "label": "Supplier Network with Xinjiang-Based Entity", "value": 2, "level": "elevated", "risk_categories": [ { "id": "forced_labor", "label": "Forced labor", "risk_factors": [ "forced_labor_xinjiang_origin_subtier" ] } ], "source_entity_ids": [ "FFgmjk4bK6vDn25yMypciw" ], "network_paths": [ [ { "sayari_entity_id": "doWJaXqr57DBYPyHcF_BxQ", "sayari_entity_label": "LIBERTY MILLS LIMITED", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2024-03-08", "last_observed": "2024-03-14", "start_date": "2024-03-08", "shares": {} }, { "sayari_entity_id": "A3YwnnynaDQnlinlbt-UlQ", "sayari_entity_label": "XINXIANG CHEMICAL FIBRE CO., LTD", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2024-03-11", "last_observed": "2024-03-25", "start_date": "2024-03-11", "shares": {} } ] ], "metadata": [ { "traversal_path": [ "FFgmjk4bK6vDn25yMypciw|receives_from|doWJaXqr57DBYPyHcF_BxQ|receives_from|A3YwnnynaDQnlinlbt-UlQ" ] } ], "risk_intelligence": [ { "type": "financial_risk_score", "score": 36, "Label": "S&P RiskGauge Credit Risk" } ] }, { "id": "forced_labor_sheffield_hallam_university_reports_origin_subtier", "label": "Supplier Network with Entity from Sheffield Hallam University Forced Labor Reports", "value": 2, "level": "elevated", "risk_categories": [ { "id": "forced_labor", "label": "Forced labor", "risk_factors": [ "forced_labor_sheffield_hallam_university_reports_origin_subtier" ] } ], "source_entity_ids": [ "FFgmjk4bK6vDn25yMypciw" ], "network_paths": [ [ { "sayari_entity_id": "hky4niXTOuJOZ3YJUHBvpw", "sayari_entity_label": "KOHINOOR TEXTILE MILLS LIMITED", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2023-09-27", "last_observed": "2023-09-27", "start_date": "2023-09-27", "shares": {} }, { "sayari_entity_id": "jcG2-gcTVXhH6J2UO7bASg", "sayari_entity_label": "WEIQIAO TEXTILE COMPANY LIMITED", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2017-03-08", "last_observed": "2025-04-21", "start_date": "2017-03-08", "shares": {} } ] ], "metadata": [ { "traversal_path": [ "FFgmjk4bK6vDn25yMypciw|receives_from|hky4niXTOuJOZ3YJUHBvpw|receives_from|jcG2-gcTVXhH6J2UO7bASg" ] } ], "risk_intelligence": [ { "type": "financial_risk_score", "score": 36, "Label": "S&P RiskGauge Credit Risk" } ] }, { "id": "forced_labor_uflpa_origin_subtier", "label": "Supplier Network with UFLPA Entity", "value": 3, "level": "elevated", "risk_categories": [ { "id": "forced_labor", "label": "Forced labor", "risk_factors": [ "forced_labor_uflpa_origin_subtier" ] } ], "source_entity_ids": [ "FFgmjk4bK6vDn25yMypciw" ], "network_paths": [ [ { "sayari_entity_id": "Lg1BHckRWGrKUT03LUy3iw", "sayari_entity_label": "KAMAL LIMITED", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2024-04-29", "last_observed": "2025-04-21", "start_date": "2024-04-29", "shares": {} }, { "sayari_entity_id": "rmgKmpNeQxhVNnrnemI2yQ", "sayari_entity_label": "CôNG TY TRáCH NHIệM HữU HạN HYOSUNG ĐồNG NAI", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2023-09-28", "last_observed": "2025-04-13", "start_date": "2023-09-28", "shares": {} }, { "sayari_entity_id": "CZAZypVNS-jkOGzpRpCXEw", "sayari_entity_label": "HANGZHOU UNION BIOTECHNOLOGY CO., LTD", "relationship_type": "receives_from", "relationship_status": "active", "former": false, "first_observed": "2023-03-09", "last_observed": "2025-02-27", "start_date": "2023-03-09", "shares": {} } ] ], "metadata": [ { "traversal_path": [ "FFgmjk4bK6vDn25yMypciw|receives_from|Lg1BHckRWGrKUT03LUy3iw|receives_from|rmgKmpNeQxhVNnrnemI2yQ|receives_from|CZAZypVNS-jkOGzpRpCXEw" ] } ], "risk_intelligence": [ { "type": "financial_risk_score", "score": 36, "Label": "S&P RiskGauge Credit Risk" } ] } ] }, "filters": { "risk_factor": [ "imports_ilab_child_labor", "forced_labor_xinjiang_origin_subtier" ], "risk_category": [ "forced_labor" ] } } ``` **SDK Code** ```python import requests url = "https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary" querystring = {"filter":"{\"risk_factor\":[\"sanctioned\",\"regulatory_action\"],\"risk_category\":[\"sanctions\",\"export_controls\"]}"} headers = {"Authorization": "."} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D'; const options = {method: 'GET', headers: {Authorization: '.'}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", ".") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = '.' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D") .header("Authorization", ".") .asString(); ``` ```php request('GET', 'https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D', [ 'headers' => [ 'Authorization' => '.', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "."); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "."] let request = NSMutableURLRequest(url: NSURL(string: "https://api.sayari.com/v1/projects/YVB88Y/entities/52z4Wa/risk_summary?filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%7D")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```