> 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 Entities

GET https://api.sayari.com/v1/projects/{project_id}/entities

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.

Reference: https://documentation.sayari.com/api/api-reference/project-entity/get-project-entities

## Authentication

- OAuth2 — send the obtained token as `Authorization: Bearer <token>`

## 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)

### Query parameters

- `next` (string, optional) — The pagination token for the next page of projects.
- `prev` (string, optional) — The pagination token for the previous page of projects.
- `limit` (integer, optional) — Limit total values returned for projects. Defaults to 100. Max 100.
- `filter` (ProjectEntitiesFilter, optional) — 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

### 200

- `limit` (integer, required)
- `data` (list of ProjectEntityResponse, required)
- `size` (QualifiedCount, required)
- `next` (string, optional)
- `prev` (string, optional)

## 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

### ProjectEntitiesFilter

- `risk_factor` (list of enum, optional) — Filter by [risk factor](/sayari-library/ontology/risk-factors) ID.
  - Allowed values: `aspi_uyghur_forced_labor_report_entity`, `aspi_uyghur_forced_labor_report_entity_adjacent`, `basel_aml`, `bis_addresses_high_diversion_risk`, `bis_affiliates_50_percent_rule`, `bis_boycott_requester_list`, `bis_entity_minority_ownership`, `bis_meu_minority_ownership`, `china_state_asset_controller`, `chinese_core_soe`, `chinese_soe_adjacent`, `chinese_state_owned`, `cmic_entity`, `cmic_entity_50_percent_rule`, `controlled_by_aus_sanctioned`, `controlled_by_bis_entity`, `controlled_by_bis_meu`, `controlled_by_eu_sanctioned`, `controlled_by_implausible_date_of_birth`, `controlled_by_jpn_sanctioned`, `controlled_by_mass_business_registration`, `controlled_by_ofac_fto_sanctioned`, `controlled_by_ofac_illicit_drugs_eo14059_sanctioned`, `controlled_by_ofac_sdgt_sanctioned`, `controlled_by_ofac_sdn`, `controlled_by_ofac_sdnt_sanctioned`, `controlled_by_ofac_sdntk_sanctioned`, `controlled_by_tcsp_keyword_risk`, `controlled_by_uk_sanctioned`, `controlled_by_ukr_sanctioned`, `controlled_by_un_sanctioned`, `cpi_score`, `entity_licensed_with_fsb_rf`, `esg_score_high`, `esg_score_medium`, `esg_score_very_high`, `eu_50_percent_rule`, `eu_high_risk_third`, `eu_minority_ownership`, `eu_sanctioned`, `export_controls`, `export_controls_adjacent`, `export_controls_bis_entity`, `export_controls_bis_entity_50_percent_rule`, `export_controls_bis_meu`, `export_controls_bis_meu_50_percent_rule`, `export_controls_other`, `export_controls_other_adjacent`, `export_controls_section_1260h`, `export_controls_section_1260h_50_percent_rule`, `export_controls_unverified_list`, `export_controls_unverified_list_50_percent_rule`, `export_to_blr_soe`, `export_to_chinese_soe`, `export_to_rus_soe`, `export_to_sanctioned`, `export_to_sanctioned_other`, `export_to_soe`, `exports_bis_high_priority_items_critical_components_direct`, `exports_bis_high_priority_items_critical_components_indirect`, `exports_bis_high_priority_items_direct`, `exports_bis_high_priority_items_indirect`, `exports_conflict_minerals`, `exports_eudr_shipment_cattle`, `exports_eudr_shipment_cocoa`, `exports_eudr_shipment_coffee`, `exports_eudr_shipment_palm_oil`, `exports_eudr_shipment_rubber`, `exports_eudr_shipment_soya`, `exports_eudr_shipment_wood`, `exports_ilab_child_labor`, `exports_ilab_forced_labor`, `exports_russian_coal`, `exports_russian_gold`, `exports_russian_important_good`, `exports_russian_oil`, `exports_to_bis_addresses_high_diversion_risk`, `exports_to_entity_licensed_with_fsb_rf`, `exports_to_jpn_meti_end_user_entity`, `exports_to_jpn_mofa_export_ban_entity`, `exports_to_sanctioned_arg_repet_jus_entity`, `exports_to_sanctioned_aus_dfat_entity`, `exports_to_sanctioned_bel_fpsf_entity`, `exports_to_sanctioned_can_gac_entity`, `exports_to_sanctioned_che_seco_entity`, `exports_to_sanctioned_cze_mof_entity`, `exports_to_sanctioned_eu_dg_fisma_ec_entity`, `exports_to_sanctioned_eu_ec_regulation_833_2014_entity`, `exports_to_sanctioned_eu_ec_sanctions_map_entity`, `exports_to_sanctioned_eu_sanctions_entity`, `exports_to_sanctioned_fra_dgt_mefids_entity`, `exports_to_sanctioned_gbr_fcdo_entity`, `exports_to_sanctioned_gbr_hmt_ofsi_entity`, `exports_to_sanctioned_isr_mod_nbctf_entity`, `exports_to_sanctioned_jpn_mof_entity`, `exports_to_sanctioned_ltu_mi_entity`, `exports_to_sanctioned_lva_fis_entity`, `exports_to_sanctioned_mys_moha_entity`, `exports_to_sanctioned_nld_mofa_entity`, `exports_to_sanctioned_nzl_mfat_rus_entity`, `exports_to_sanctioned_pol_mia_entity`, `exports_to_sanctioned_sgp_agc_entity`, `exports_to_sanctioned_ukr_nsdc_entity`, `exports_to_sanctioned_ukr_sfms_entity`, `exports_to_sanctioned_un_sc_entity`, `exports_to_sanctioned_usa_ofac_non_sdn_entity`, `exports_to_sanctioned_usa_ofac_sdn_entity`, `exports_to_sanctioned_xxx_ebrd_entity`, `exports_to_sanctioned_xxx_iabd_entity`, `exports_to_usa_aeca_debarred_entity`, `exports_to_usa_bis_denied_persons_entity`, `exports_to_usa_bis_entity`, `exports_to_usa_bis_meu_entity`, `exports_to_usa_bis_unverified_entity`, `exports_to_usa_isn_entity`, `exports_to_usa_section_1260h_entity`, `forced_labor_aspi_origin_direct`, `forced_labor_aspi_origin_subtier`, `forced_labor_aspi_origin_subtier_product_blueprint`, `forced_labor_china_keywords`, `forced_labor_sheffield_hallam_university_reports_origin_direct`, `forced_labor_sheffield_hallam_university_reports_origin_subtier`, `forced_labor_sheffield_hallam_university_reports_origin_subtier_product_blueprint`, `forced_labor_uflpa_origin_direct`, `forced_labor_uflpa_origin_subtier`, `forced_labor_uflpa_origin_subtier_product_blueprint`, `forced_labor_wro_origin_direct`, `forced_labor_wro_origin_subtier`, `forced_labor_wro_origin_subtier_product_blueprint`, `forced_labor_xinjiang_contractors`, `forced_labor_xinjiang_cotton_entity`, `forced_labor_xinjiang_geospatial`, `forced_labor_xinjiang_name`, `forced_labor_xinjiang_operations`, `forced_labor_xinjiang_origin_direct`, `forced_labor_xinjiang_origin_subtier`, `forced_labor_xinjiang_origin_subtier_product_blueprint`, `forced_labor_xinjiang_registration`, `forced_labor_xinjiang_uflpa`, `forced_labor_xinjiang_uflpa_adjacent`, `former_soe`, `former_wro_entity`, `formerly_sanctioned`, `formerly_sanctioned_arg_repet_jus`, `formerly_sanctioned_aus_dfat`, `formerly_sanctioned_bel_fpsf`, `formerly_sanctioned_can_gac`, `formerly_sanctioned_che_seco`, `formerly_sanctioned_cze_mof`, `formerly_sanctioned_eu_dg_fisma_ec`, `formerly_sanctioned_eu_ec_regulation_833_2014`, `formerly_sanctioned_eu_ec_sanctions_map`, `formerly_sanctioned_eu_sanctions`, `formerly_sanctioned_fra_dgt_mefids`, `formerly_sanctioned_gbr_fcdo`, `formerly_sanctioned_gbr_hmt_ofsi`, `formerly_sanctioned_isr_mod_nbctf`, `formerly_sanctioned_jpn_mof`, `formerly_sanctioned_ltu_mi`, `formerly_sanctioned_lva_fis`, `formerly_sanctioned_mys_moha`, `formerly_sanctioned_nld_mofa`, `formerly_sanctioned_nzl_mfat_rus`, `formerly_sanctioned_pol_mia`, `formerly_sanctioned_sgp_agc`, `formerly_sanctioned_ukr_nsdc`, `formerly_sanctioned_ukr_sfms`, `formerly_sanctioned_un_sc`, `formerly_sanctioned_usa_ofac_non_sdn`, `formerly_sanctioned_usa_ofac_sdn`, `formerly_sanctioned_xxx_ebrd`, `formerly_sanctioned_xxx_iabd`, `implausible_date_of_birth`, `imports_bis_high_priority_items`, `imports_bis_high_priority_items_critical_components`, `imports_conflict_minerals`, `imports_eudr_shipment_cattle`, `imports_eudr_shipment_cocoa`, `imports_eudr_shipment_coffee`, `imports_eudr_shipment_palm_oil`, `imports_eudr_shipment_rubber`, `imports_eudr_shipment_soya`, `imports_eudr_shipment_wood`, `imports_from_bis_addresses_high_diversion_risk`, `imports_ilab_child_labor`, `imports_ilab_forced_labor`, `imports_ndaa_889_telecom_equipment`, `imports_russian_coal`, `imports_russian_gold`, `imports_russian_important_good`, `imports_russian_oil`, `jpn_meti_end_user`, `jpn_mofa_export_ban`, `law_enforcement_action`, `law_enforcement_action_breaking`, `law_enforcement_action_historic`, `law_enforcement_action_recent`, `mass_address_usage`, `mass_business_registration`, `meu_list_contractors`, `military_civil_fusion`, `military_civil_fusion_50_percent_rule`, `military_end_use_china_keywords`, `ndaa_889_covered_entities`, `ofac_50_percent_rule`, `ofac_fto_sanctioned`, `ofac_illicit_drugs_eo14059_sanctioned`, `ofac_minority_ownership`, `ofac_sdgt_sanctioned`, `ofac_sdn`, `ofac_sdn_mex_dto_sanctioned`, `ofac_sdn_mex_dto_sanctioned_adjacent`, `ofac_sdnt_sanctioned`, `ofac_sdntk_sanctioned`, `owned_by_aspi_forced_labor_entity`, `owned_by_bis_meu_entity`, `owned_by_blr_soe`, `owned_by_chinese_soe`, `owned_by_cmic_entity`, `owned_by_entity_in_export_controls`, `owned_by_entity_in_export_controls_other`, `owned_by_forced_labor_xinjiang_uflpa`, `owned_by_jpn_meti_end_user_entity`, `owned_by_jpn_mofa_export_ban_entity`, `owned_by_military_civil_fusion`, `owned_by_ofac_fto_sanctioned`, `owned_by_ofac_illicit_drugs_eo14059_sanctioned`, `owned_by_ofac_sdgt_sanctioned`, `owned_by_ofac_sdn_mex_dto_sanctioned`, `owned_by_ofac_sdnt_sanctioned`, `owned_by_ofac_sdntk_sanctioned`, `owned_by_regulatory_action_entity`, `owned_by_rus_soe`, `owned_by_sanctioned_arg_repet_jus_entity`, `owned_by_sanctioned_aus_dfat_entity`, `owned_by_sanctioned_bel_fpsf_entity`, `owned_by_sanctioned_can_gac_entity`, `owned_by_sanctioned_che_seco_entity`, `owned_by_sanctioned_cze_mof_entity`, `owned_by_sanctioned_entity`, `owned_by_sanctioned_eu_dg_fisma_ec_entity`, `owned_by_sanctioned_eu_ec_regulation_833_2014_entity`, `owned_by_sanctioned_eu_ec_sanctions_map_entity`, `owned_by_sanctioned_eu_sanctions_entity`, `owned_by_sanctioned_fra_dgt_mefids_entity`, `owned_by_sanctioned_gbr_fcdo_entity`, `owned_by_sanctioned_gbr_hmt_ofsi_entity`, `owned_by_sanctioned_isr_mod_nbctf_entity`, `owned_by_sanctioned_jpn_mof_entity`, `owned_by_sanctioned_ltu_mi_entity`, `owned_by_sanctioned_lva_fis_entity`, `owned_by_sanctioned_mys_moha_entity`, `owned_by_sanctioned_nld_mofa_entity`, `owned_by_sanctioned_nzl_mfat_rus_entity`, `owned_by_sanctioned_other_entity`, `owned_by_sanctioned_pol_mia_entity`, `owned_by_sanctioned_sgp_agc_entity`, `owned_by_sanctioned_ukr_nsdc_entity`, `owned_by_sanctioned_ukr_sfms_entity`, `owned_by_sanctioned_un_sc_entity`, `owned_by_sanctioned_usa_ofac_non_sdn_entity`, `owned_by_sanctioned_usa_ofac_sdn_entity`, `owned_by_sanctioned_xxx_ebrd_entity`, `owned_by_sanctioned_xxx_iabd_entity`, `owned_by_section_1260h_entity`, `owned_by_sheffield_hallam_university_reports_forced_labor_entity`, `owned_by_soe`, `owned_by_tcsp_keyword_risk`, `owned_by_usa_aeca_debarred_entity`, `owned_by_usa_bis_denied_persons_entity`, `owned_by_usa_bis_entity`, `owned_by_usa_bis_meu_entity`, `owned_by_usa_bis_unverified_entity`, `owned_by_usa_isn_entity`, `owned_by_usa_section_1260h_entity`, `owned_by_wro_entity`, `owned_by_xinjiang_entity`, `owner_of_aspi_forced_labor_entity`, `owner_of_blr_soe`, `owner_of_chinese_soe`, `owner_of_export_controls_entity`, `owner_of_export_controls_other_entity`, `owner_of_forced_labor_xinjiang_entity`, `owner_of_forced_labor_xinjiang_uflpa`, `owner_of_jpn_meti_end_user_entity`, `owner_of_jpn_mofa_export_ban_entity`, `owner_of_ofac_fto_sanctioned`, `owner_of_ofac_illicit_drugs_eo14059_sanctioned`, `owner_of_ofac_sdgt_sanctioned`, `owner_of_ofac_sdn_mex_dto_sanctioned`, `owner_of_ofac_sdnt_sanctioned`, `owner_of_ofac_sdntk_sanctioned`, `owner_of_regulatory_action_entity`, `owner_of_rus_soe`, `owner_of_sanctioned_arg_repet_jus_entity`, `owner_of_sanctioned_aus_dfat_entity`, `owner_of_sanctioned_bel_fpsf_entity`, `owner_of_sanctioned_can_gac_entity`, `owner_of_sanctioned_che_seco_entity`, `owner_of_sanctioned_cze_mof_entity`, `owner_of_sanctioned_entity`, `owner_of_sanctioned_eu_dg_fisma_ec_entity`, `owner_of_sanctioned_eu_ec_regulation_833_2014_entity`, `owner_of_sanctioned_eu_ec_sanctions_map_entity`, `owner_of_sanctioned_eu_sanctions_entity`, `owner_of_sanctioned_fra_dgt_mefids_entity`, `owner_of_sanctioned_gbr_fcdo_entity`, `owner_of_sanctioned_gbr_hmt_ofsi_entity`, `owner_of_sanctioned_isr_mod_nbctf_entity`, `owner_of_sanctioned_jpn_mof_entity`, `owner_of_sanctioned_ltu_mi_entity`, `owner_of_sanctioned_lva_fis_entity`, `owner_of_sanctioned_mys_moha_entity`, `owner_of_sanctioned_nld_mofa_entity`, `owner_of_sanctioned_nzl_mfat_rus_entity`, `owner_of_sanctioned_other_entity`, `owner_of_sanctioned_pol_mia_entity`, `owner_of_sanctioned_sgp_agc_entity`, `owner_of_sanctioned_ukr_nsdc_entity`, `owner_of_sanctioned_ukr_sfms_entity`, `owner_of_sanctioned_un_sc_entity`, `owner_of_sanctioned_usa_ofac_non_sdn_entity`, `owner_of_sanctioned_usa_ofac_sdn_entity`, `owner_of_sanctioned_xxx_ebrd_entity`, `owner_of_sanctioned_xxx_iabd_entity`, `owner_of_sheffield_hallam_university_reports_forced_labor_entity`, `owner_of_soe`, `owner_of_usa_aeca_debarred_entity`, `owner_of_usa_bis_denied_persons_entity`, `owner_of_usa_bis_entity`, `owner_of_usa_bis_meu_entity`, `owner_of_usa_bis_unverified_entity`, `owner_of_usa_isn_entity`, `owner_of_usa_section_1260h_entity`, `owner_of_wro_entity`, `pep`, `pep_adjacent`, `psa_bis_boycott_requester_list`, `psa_bis_entity_minority_ownership`, `psa_bis_meu_minority_ownership`, `psa_chinese_state_owned`, `psa_cmic_entity_50_percent_rule`, `psa_entity_licensed_with_fsb_rf`, `psa_eu_50_percent_rule`, `psa_eu_minority_ownership`, `psa_export_controls`, `psa_export_controls_bis_entity_50_percent_rule`, `psa_export_controls_bis_meu_50_percent_rule`, `psa_export_controls_other`, `psa_export_controls_section_1260h_50_percent_rule`, `psa_export_controls_unverified_list_50_percent_rule`, `psa_export_to_blr_soe`, `psa_export_to_chinese_soe`, `psa_export_to_rus_soe`, `psa_export_to_sanctioned`, `psa_export_to_sanctioned_other`, `psa_export_to_soe`, `psa_exports_bis_high_priority_items_critical_components_direct`, `psa_exports_bis_high_priority_items_critical_components_indirect`, `psa_exports_bis_high_priority_items_direct`, `psa_exports_bis_high_priority_items_indirect`, `psa_exports_conflict_minerals`, `psa_exports_eudr_shipment_cattle`, `psa_exports_eudr_shipment_cocoa`, `psa_exports_eudr_shipment_coffee`, `psa_exports_eudr_shipment_palm_oil`, `psa_exports_eudr_shipment_rubber`, `psa_exports_eudr_shipment_soya`, `psa_exports_eudr_shipment_wood`, `psa_exports_ilab_child_labor`, `psa_exports_ilab_forced_labor`, `psa_exports_russian_coal`, `psa_exports_russian_gold`, `psa_exports_russian_important_good`, `psa_exports_russian_oil`, `psa_exports_to_bis_addresses_high_diversion_risk`, `psa_exports_to_entity_licensed_with_fsb_rf`, `psa_exports_to_jpn_meti_end_user_entity`, `psa_exports_to_jpn_mofa_export_ban_entity`, `psa_exports_to_sanctioned_arg_repet_jus_entity`, `psa_exports_to_sanctioned_aus_dfat_entity`, `psa_exports_to_sanctioned_bel_fpsf_entity`, `psa_exports_to_sanctioned_can_gac_entity`, `psa_exports_to_sanctioned_che_seco_entity`, `psa_exports_to_sanctioned_cze_mof_entity`, `psa_exports_to_sanctioned_eu_dg_fisma_ec_entity`, `psa_exports_to_sanctioned_eu_ec_regulation_833_2014_entity`, `psa_exports_to_sanctioned_eu_ec_sanctions_map_entity`, `psa_exports_to_sanctioned_eu_sanctions_entity`, `psa_exports_to_sanctioned_fra_dgt_mefids_entity`, `psa_exports_to_sanctioned_gbr_fcdo_entity`, `psa_exports_to_sanctioned_gbr_hmt_ofsi_entity`, `psa_exports_to_sanctioned_isr_mod_nbctf_entity`, `psa_exports_to_sanctioned_jpn_mof_entity`, `psa_exports_to_sanctioned_ltu_mi_entity`, `psa_exports_to_sanctioned_lva_fis_entity`, `psa_exports_to_sanctioned_mys_moha_entity`, `psa_exports_to_sanctioned_nld_mofa_entity`, `psa_exports_to_sanctioned_nzl_mfat_rus_entity`, `psa_exports_to_sanctioned_pol_mia_entity`, `psa_exports_to_sanctioned_sgp_agc_entity`, `psa_exports_to_sanctioned_ukr_nsdc_entity`, `psa_exports_to_sanctioned_ukr_sfms_entity`, `psa_exports_to_sanctioned_un_sc_entity`, `psa_exports_to_sanctioned_usa_ofac_non_sdn_entity`, `psa_exports_to_sanctioned_usa_ofac_sdn_entity`, `psa_exports_to_sanctioned_xxx_ebrd_entity`, `psa_exports_to_sanctioned_xxx_iabd_entity`, `psa_exports_to_usa_aeca_debarred_entity`, `psa_exports_to_usa_bis_denied_persons_entity`, `psa_exports_to_usa_bis_entity`, `psa_exports_to_usa_bis_meu_entity`, `psa_exports_to_usa_bis_unverified_entity`, `psa_exports_to_usa_isn_entity`, `psa_exports_to_usa_section_1260h_entity`, `psa_forced_labor_aspi_origin_direct`, `psa_forced_labor_aspi_origin_subtier`, `psa_forced_labor_aspi_uyghur`, `psa_forced_labor_sheffield_hallam_university_reports_origin_direct`, `psa_forced_labor_sheffield_hallam_university_reports_origin_subtier`, `psa_forced_labor_uflpa_origin_direct`, `psa_forced_labor_uflpa_origin_subtier`, `psa_forced_labor_wro_origin_direct`, `psa_forced_labor_wro_origin_subtier`, `psa_forced_labor_xinjiang_cotton_entity`, `psa_forced_labor_xinjiang_geospatial`, `psa_forced_labor_xinjiang_name`, `psa_forced_labor_xinjiang_operations`, `psa_forced_labor_xinjiang_origin_direct`, `psa_forced_labor_xinjiang_origin_subtier`, `psa_forced_labor_xinjiang_registration`, `psa_forced_labor_xinjiang_uflpa`, `psa_imports_bis_high_priority_items`, `psa_imports_bis_high_priority_items_critical_components`, `psa_imports_conflict_minerals`, `psa_imports_eudr_shipment_cattle`, `psa_imports_eudr_shipment_cocoa`, `psa_imports_eudr_shipment_coffee`, `psa_imports_eudr_shipment_palm_oil`, `psa_imports_eudr_shipment_rubber`, `psa_imports_eudr_shipment_soya`, `psa_imports_eudr_shipment_wood`, `psa_imports_from_bis_addresses_high_diversion_risk`, `psa_imports_ilab_child_labor`, `psa_imports_ilab_forced_labor`, `psa_imports_ndaa_889_telecom_equipment`, `psa_imports_russian_coal`, `psa_imports_russian_gold`, `psa_imports_russian_important_good`, `psa_imports_russian_oil`, `psa_jpn_meti_end_user`, `psa_jpn_mofa_export_ban`, `psa_military_civil_fusion`, `psa_military_civil_fusion_50_percent_rule`, `psa_ofac_50_percent_rule`, `psa_ofac_minority_ownership`, `psa_ofac_sdn_mex_dto_sanctioned_adjacent`, `psa_owned_by_aspi_forced_labor_entity`, `psa_owned_by_bis_meu_entity`, `psa_owned_by_blr_soe`, `psa_owned_by_chinese_soe`, `psa_owned_by_cmic_entity`, `psa_owned_by_entity_in_export_controls`, `psa_owned_by_entity_in_export_controls_other`, `psa_owned_by_forced_labor_xinjiang_uflpa`, `psa_owned_by_jpn_meti_end_user_entity`, `psa_owned_by_jpn_mofa_export_ban_entity`, `psa_owned_by_military_civil_fusion`, `psa_owned_by_ofac_fto_sanctioned`, `psa_owned_by_ofac_illicit_drugs_eo14059_sanctioned`, `psa_owned_by_ofac_sdgt_sanctioned`, `psa_owned_by_ofac_sdn_mex_dto_sanctioned`, `psa_owned_by_ofac_sdnt_sanctioned`, `psa_owned_by_ofac_sdntk_sanctioned`, `psa_owned_by_regulatory_action_entity`, `psa_owned_by_rus_soe`, `psa_owned_by_sanctioned_arg_repet_jus_entity`, `psa_owned_by_sanctioned_aus_dfat_entity`, `psa_owned_by_sanctioned_bel_fpsf_entity`, `psa_owned_by_sanctioned_can_gac_entity`, `psa_owned_by_sanctioned_che_seco_entity`, `psa_owned_by_sanctioned_cze_mof_entity`, `psa_owned_by_sanctioned_entity`, `psa_owned_by_sanctioned_eu_dg_fisma_ec_entity`, `psa_owned_by_sanctioned_eu_ec_regulation_833_2014_entity`, `psa_owned_by_sanctioned_eu_ec_sanctions_map_entity`, `psa_owned_by_sanctioned_eu_sanctions_entity`, `psa_owned_by_sanctioned_fra_dgt_mefids_entity`, `psa_owned_by_sanctioned_gbr_fcdo_entity`, `psa_owned_by_sanctioned_gbr_hmt_ofsi_entity`, `psa_owned_by_sanctioned_isr_mod_nbctf_entity`, `psa_owned_by_sanctioned_jpn_mof_entity`, `psa_owned_by_sanctioned_ltu_mi_entity`, `psa_owned_by_sanctioned_lva_fis_entity`, `psa_owned_by_sanctioned_mys_moha_entity`, `psa_owned_by_sanctioned_nld_mofa_entity`, `psa_owned_by_sanctioned_nzl_mfat_rus_entity`, `psa_owned_by_sanctioned_other_entity`, `psa_owned_by_sanctioned_pol_mia_entity`, `psa_owned_by_sanctioned_sgp_agc_entity`, `psa_owned_by_sanctioned_ukr_nsdc_entity`, `psa_owned_by_sanctioned_ukr_sfms_entity`, `psa_owned_by_sanctioned_un_sc_entity`, `psa_owned_by_sanctioned_usa_ofac_non_sdn_entity`, `psa_owned_by_sanctioned_usa_ofac_sdn_entity`, `psa_owned_by_sanctioned_xxx_ebrd_entity`, `psa_owned_by_sanctioned_xxx_iabd_entity`, `psa_owned_by_section_1260h_entity`, `psa_owned_by_sheffield_hallam_university_reports_forced_labor_entity`, `psa_owned_by_soe`, `psa_owned_by_usa_aeca_debarred_entity`, `psa_owned_by_usa_bis_denied_persons_entity`, `psa_owned_by_usa_bis_entity`, `psa_owned_by_usa_bis_meu_entity`, `psa_owned_by_usa_bis_unverified_entity`, `psa_owned_by_usa_isn_entity`, `psa_owned_by_usa_section_1260h_entity`, `psa_owned_by_wro_entity`, `psa_owned_by_xinjiang_entity`, `psa_owner_of_aspi_forced_labor_entity`, `psa_owner_of_blr_soe`, `psa_owner_of_chinese_soe`, `psa_owner_of_export_controls_entity`, `psa_owner_of_export_controls_other_entity`, `psa_owner_of_forced_labor_xinjiang_entity`, `psa_owner_of_forced_labor_xinjiang_uflpa`, `psa_owner_of_jpn_meti_end_user_entity`, `psa_owner_of_jpn_mofa_export_ban_entity`, `psa_owner_of_ofac_fto_sanctioned`, `psa_owner_of_ofac_illicit_drugs_eo14059_sanctioned`, `psa_owner_of_ofac_sdgt_sanctioned`, `psa_owner_of_ofac_sdn_mex_dto_sanctioned`, `psa_owner_of_ofac_sdnt_sanctioned`, `psa_owner_of_ofac_sdntk_sanctioned`, `psa_owner_of_regulatory_action_entity`, `psa_owner_of_rus_soe`, `psa_owner_of_sanctioned_arg_repet_jus_entity`, `psa_owner_of_sanctioned_aus_dfat_entity`, `psa_owner_of_sanctioned_bel_fpsf_entity`, `psa_owner_of_sanctioned_can_gac_entity`, `psa_owner_of_sanctioned_che_seco_entity`, `psa_owner_of_sanctioned_cze_mof_entity`, `psa_owner_of_sanctioned_entity`, `psa_owner_of_sanctioned_eu_dg_fisma_ec_entity`, `psa_owner_of_sanctioned_eu_ec_regulation_833_2014_entity`, `psa_owner_of_sanctioned_eu_ec_sanctions_map_entity`, `psa_owner_of_sanctioned_eu_sanctions_entity`, `psa_owner_of_sanctioned_fra_dgt_mefids_entity`, `psa_owner_of_sanctioned_gbr_fcdo_entity`, `psa_owner_of_sanctioned_gbr_hmt_ofsi_entity`, `psa_owner_of_sanctioned_isr_mod_nbctf_entity`, `psa_owner_of_sanctioned_jpn_mof_entity`, `psa_owner_of_sanctioned_ltu_mi_entity`, `psa_owner_of_sanctioned_lva_fis_entity`, `psa_owner_of_sanctioned_mys_moha_entity`, `psa_owner_of_sanctioned_nld_mofa_entity`, `psa_owner_of_sanctioned_nzl_mfat_rus_entity`, `psa_owner_of_sanctioned_other_entity`, `psa_owner_of_sanctioned_pol_mia_entity`, `psa_owner_of_sanctioned_sgp_agc_entity`, `psa_owner_of_sanctioned_ukr_nsdc_entity`, `psa_owner_of_sanctioned_ukr_sfms_entity`, `psa_owner_of_sanctioned_un_sc_entity`, `psa_owner_of_sanctioned_usa_ofac_non_sdn_entity`, `psa_owner_of_sanctioned_usa_ofac_sdn_entity`, `psa_owner_of_sanctioned_xxx_ebrd_entity`, `psa_owner_of_sanctioned_xxx_iabd_entity`, `psa_owner_of_sheffield_hallam_university_reports_forced_labor_entity`, `psa_owner_of_soe`, `psa_owner_of_usa_aeca_debarred_entity`, `psa_owner_of_usa_bis_denied_persons_entity`, `psa_owner_of_usa_bis_entity`, `psa_owner_of_usa_bis_meu_entity`, `psa_owner_of_usa_bis_unverified_entity`, `psa_owner_of_usa_isn_entity`, `psa_owner_of_usa_section_1260h_entity`, `psa_owner_of_wro_entity`, `psa_pep`, `psa_regulatory_action`, `psa_sanctioned`, `psa_sanctioned_arg_repet_jus`, `psa_sanctioned_aus_dfat`, `psa_sanctioned_bel_fpsf`, `psa_sanctioned_can_gac`, `psa_sanctioned_che_seco`, `psa_sanctioned_cze_mof`, `psa_sanctioned_eu_dg_fisma_ec`, `psa_sanctioned_eu_ec_regulation_833_2014`, `psa_sanctioned_eu_ec_sanctions_map`, `psa_sanctioned_eu_sanctions`, `psa_sanctioned_fra_dgt_mefids`, `psa_sanctioned_gbr_fcdo`, `psa_sanctioned_gbr_hmt_ofsi`, `psa_sanctioned_isr_mod_nbctf`, `psa_sanctioned_jpn_mof`, `psa_sanctioned_ltu_mi`, `psa_sanctioned_lva_fis`, `psa_sanctioned_mys_moha`, `psa_sanctioned_nld_mofa`, `psa_sanctioned_nzl_mfat_rus`, `psa_sanctioned_other`, `psa_sanctioned_pol_mia`, `psa_sanctioned_sgp_agc`, `psa_sanctioned_ukr_nsdc`, `psa_sanctioned_ukr_sfms`, `psa_sanctioned_un_sc`, `psa_sanctioned_usa_ofac_non_sdn`, `psa_sanctioned_usa_ofac_sdn`, `psa_sanctioned_xxx_ebrd`, `psa_sanctioned_xxx_iabd`, `psa_sheffield_hallam_university_forced_labor_entity`, `psa_sheffield_hallam_university_intermediary_entity`, `psa_sheffield_hallam_university_useful_resources`, `psa_state_owned`, `psa_state_owned_blr`, `psa_state_owned_rus`, `psa_state_owned_ven`, `psa_uk_50_percent_rule`, `psa_uk_minority_ownership`, `psa_usa_aeca_debarred`, `psa_usa_bis`, `psa_usa_bis_50_percent_rule`, `psa_usa_bis_denied_persons`, `psa_usa_bis_meu`, `psa_usa_bis_meu_50_percent_rule`, `psa_usa_bis_unverified`, `psa_usa_isn`, `psa_usa_section_1260h`, `psa_ven_soe_50_percent`, `psa_wro_entity`, `regulatory_action`, `reputational_risk_bribery_and_corruption`, `reputational_risk_bribery_and_corruption_breaking`, `reputational_risk_bribery_and_corruption_historic`, `reputational_risk_bribery_and_corruption_recent`, `reputational_risk_cybercrime`, `reputational_risk_cybercrime_breaking`, `reputational_risk_cybercrime_historic`, `reputational_risk_cybercrime_recent`, `reputational_risk_financial_crime`, `reputational_risk_financial_crime_breaking`, `reputational_risk_financial_crime_historic`, `reputational_risk_financial_crime_recent`, `reputational_risk_forced_labor`, `reputational_risk_forced_labor_breaking`, `reputational_risk_forced_labor_historic`, `reputational_risk_forced_labor_recent`, `reputational_risk_organized_crime`, `reputational_risk_organized_crime_breaking`, `reputational_risk_organized_crime_historic`, `reputational_risk_organized_crime_recent`, `reputational_risk_other`, `reputational_risk_other_breaking`, `reputational_risk_other_historic`, `reputational_risk_other_recent`, `reputational_risk_terrorism`, `reputational_risk_terrorism_breaking`, `reputational_risk_terrorism_historic`, `reputational_risk_terrorism_recent`, `sanctioned`, `sanctioned_adjacent`, `sanctioned_arg_repet_jus`, `sanctioned_aus_dfat`, `sanctioned_bel_fpsf`, `sanctioned_can_gac`, `sanctioned_che_seco`, `sanctioned_cze_mof`, `sanctioned_eu_dg_fisma_ec`, `sanctioned_eu_ec_regulation_269_2014`, `sanctioned_eu_ec_regulation_833_2014`, `sanctioned_eu_ec_sanctions_map`, `sanctioned_eu_sanctions`, `sanctioned_fra_dgt_mefids`, `sanctioned_gbr_fcdo`, `sanctioned_gbr_hmt_ofsi`, `sanctioned_isr_mod_nbctf`, `sanctioned_jpn_mof`, `sanctioned_ltu_mi`, `sanctioned_lva_fis`, `sanctioned_mys_moha`, `sanctioned_nld_mofa`, `sanctioned_nzl_mfat_rus`, `sanctioned_other`, `sanctioned_other_adjacent`, `sanctioned_pol_mia`, `sanctioned_sgp_agc`, `sanctioned_ukr_nsdc`, `sanctioned_ukr_sfms`, `sanctioned_un_sc`, `sanctioned_usa_ofac_non_sdn`, `sanctioned_usa_ofac_sdn`, `sanctioned_xxx_ebrd`, `sanctioned_xxx_iabd`, `sheffield_hallam_university_forced_labor_entity`, `sheffield_hallam_university_forced_labor_reports_entity_adjacent`, `sheffield_hallam_university_forced_labor_reports_intermediary_entity`, `sheffield_hallam_university_useful_resources`, `soe_adjacent`, `state_owned`, `state_owned_blr`, `state_owned_rus`, `state_owned_ven`, `subsidiary_of_ndaa_889_covered_entities`, `tcsp_keyword_risk`, `uk_50_percent_rule`, `uk_minority_ownership`, `uk_sanctioned`, `usa_aeca_debarred`, `usa_bis`, `usa_bis_50_percent_rule`, `usa_bis_denied_persons`, `usa_bis_meu`, `usa_bis_meu_50_percent_rule`, `usa_bis_unverified`, `usa_isn`, `usa_section_1260h`, `ven_soe_50_percent`, `wro_entity`, `wro_entity_adjacent`
- `risk_category` (list of string, optional) — Filter by risk factor `category`, e.g. `sanctions`. At least one risk factor from each provided category must be present.
- `upstream_product` (list of string, optional) — Filter by upstream (supply chain) product ID.
- `shipment_country` (list of enum, optional) — Filter by upstream (supply chain) [country](/sayari-library/ontology/enumerated-types#country) at any tier.
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `tier1_shipment_country` (list of enum, optional) — Filter by upstream (supply chain) [country](/sayari-library/ontology/enumerated-types#country) at tier 1.
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `tier2_shipment_country` (list of enum, optional) — Filter by upstream (supply chain) [country](/sayari-library/ontology/enumerated-types#country) at tier 2.
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `tier3_shipment_country` (list of enum, optional) — Filter by upstream (supply chain) [country](/sayari-library/ontology/enumerated-types#country) at tier 3.
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `tier4_shipment_country` (list of enum, optional) — Filter by upstream (supply chain) [country](/sayari-library/ontology/enumerated-types#country) at tier 4.
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `tier5_shipment_country` (list of enum, optional) — Filter by upstream (supply chain) [country](/sayari-library/ontology/enumerated-types#country) at tier 5.
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `country` (list of enum, optional) — Filter by [country](/sayari-library/ontology/enumerated-types#country).
  - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `RKS`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `UNK`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `XXX`, `YEM`, `ZAF`, `ZMB`, `ZWE`
- `business_purpose` (list of string, optional) — Filter by HS code, HS code description, or business description.
- `label` (ProjectEntitiesFuzzyFilter, optional) — Filter by entity label with fuzzy matching.
- `city` (ProjectEntitiesFuzzyFilter, optional) — Filter by entity city with fuzzy matching.
- `state` (ProjectEntitiesFuzzyFilter, optional) — Filter by entity address state with fuzzy matching.
- `identifier` (ProjectEntitiesFuzzyFilter, optional) — Filter by entity identifier attributes with fuzzy matching.
- `source` (ProjectEntitiesExactFilter, optional) — Filter by entity source ID.
- `status` (list of enum, optional) — Filter by entity [company status](/sayari-library/ontology/enumerated-types#company-status).
  - Allowed values: `active`, `closed`, `closing`, `dissolved`, `expanded`, `expired`, `in_receivership`, `inactive`, `incorporated`, `opening`, `registered`, `registration_revoked`, `seized`, `terminated`, `under_external_control`
- `bounds` (string, optional) — Filter by a geographical bounding box. The value is a pipe-delimited set of four values representing the top, left, bottom, and right sides of the bounding box, in that order. The pipes should be URL-encoded as `%7C`. The top coordinate must greater than the bottom coordinate, and the left coordinate must be less than the right coordinate. A sample is `55.680357237879136|-71.53607290158526|41.10876347746233|-40.963927098414736`
- `match_entity_id` (list of string, optional) — Filter by match entity ID.
- `entity_type` (list of string, optional) — Filter by entity type.
- `tag` (list of string, optional) — Filter by tag ID.
- `upload` (list of string, optional) — Filter by upload ID.
- `case_status` (list of enum, optional) — Filter by case status.
  - Allowed values: `not_assigned`, `in_review`, `approved`, `rejected`
- `match_strength` (list of enum, optional) — Filter by match strength.
  - Allowed values: `strong`, `partial`, `no_match`, `manual`
- `match_count` (enum, optional) — Filter by match count.
  - Allowed values: `one`, `many`
- `attribute` (ProjectEntitiesCustomFieldFilter, optional) — Filter by custom field.

### ProjectEntityResponse

- `project_entity_id` (string, required)
- `project_id` (string, required)
- `label` (string, required)
- `upload_ids` (list of string, required)
- `strength` (enum, required)
  - Allowed values: `strong`, `partial`, `no_match`, `manual`
- `created_at` (string, required)
- `attributes` (map from string to AttributeValues, required)
- `countries` (list of string, required)
- `risk_categories` (list of ProjectRiskCategory, required)
- `risk_factors` (list of ProjectRiskFactor, required)
- `upstream` (UpstreamInfo, required)
- `tags` (list of TagResponse, required)
- `matches` (list of ProjectEntityMatchResponse, required)
- `case` (CaseInfo, optional)
- `updated_at` (string, optional)
- `updated_by` (string, optional)

### QualifiedCount

- `count` (integer, required)
- `qualifier` (enum, required)
  - Allowed values: `eq`, `gte`

### ProjectEntitiesFuzzyFilter

- `fuzzy` (list of string, optional) — Filter with fuzzy matching.

### ProjectEntitiesExactFilter

- `exact` (list of string, optional) — Filter with exact matching.

### ProjectEntitiesCustomFieldFilter

- `custom_{field name}` (string, optional) — This property is in beta and is subject to change. It is provided for early access and testing purposes only. custom user key/value pairs (key must be prefixed with "custom\_" and value must be "string" type)

### AttributeValues

- `match_resolution` (boolean, required)
- `values` (list of string, required)

### ProjectRiskCategory

- `id` (string, required)
- `label` (string, required)
- `risk_factors` (list of string, required)

### ProjectRiskFactor

- `id` (string, required)

### UpstreamInfo

- `risk_factors` (list of ProjectRiskFactor, required)
- `countries` (list of string, required)
- `trade_counts` (TradeCounts, required)
- `has_upstream` (boolean, required)
- `products` (list of string, required)
- `risk_counts` (map from string to map from string to list of ProductCount, optional)
- `country_counts` (map from string to map from string to list of ProductCount, optional)

### TagResponse

- `id` (string, required)
- `label` (string, required)
- `created_at` (string, required)
- `updated_at` (string, optional)

### ProjectEntityMatchResponse

- `match_id` (string, required)
- `sayari_entity_id` (string, required)
- `type` (string, required)
- `label` (string, required)
- `countries` (list of string, required)
- `risk_categories` (list of ProjectRiskCategory, required)
- `risk_factors` (list of ProjectRiskFactor, required)
- `business_purpose` (list of BusinessPurpose, required)
- `upstream` (UpstreamInfo, required)
- `sources` (list of SourceField, required)
- `addresses` (list of Address, required)
- `hs_codes` (list of string, required)
- `created_at` (string, required)
- `updated_at` (string, optional)
- `match_profile` (enum, optional)
  - Allowed values: `corporate`, `suppliers`, `screen`, `search`
- `deleted_at` (string, optional)
- `match_explanation` (list of ProjectEntityMatchExplanation, optional)

### CaseInfo

- `id` (string, required)
- `status` (enum, required)
  - Allowed values: `not_assigned`, `in_review`, `approved`, `rejected`
- `created_at` (string, required)
- `comment` (string, optional)

### TradeCounts

- `receiver_of` (integer, required)
- `shipper_of` (integer, required)

### ProductCount

- `count` (integer, required)
- `product` (string, optional)

### BusinessPurpose

- `code` (string, required)
- `standard` (string, required)

### SourceField

- `id` (string, required)
- `label` (string, required)

### Address

- `value` (string, required)
- `country` (string, optional)
- `city` (string, optional)
- `state` (string, optional)
- `location` (Location, optional)

### ProjectEntityMatchExplanation

- `field` (string, required)
- `quality` (enum, required) — Quality of the match
  - Allowed values: `high`, `medium`, `low`, `na`
- `description` (list of string, optional)
- `matches` (list of string, optional)

### Location

- `lat` (double, required)
- `lon` (double, required)

## Examples

### Example 1

**Response**

```json
{
  "limit": 20,
  "data": [
    {
      "project_entity_id": "52z4Wa",
      "project_id": "YVB88Y",
      "label": "VTB Bank",
      "upload_ids": [],
      "strength": "strong",
      "created_at": "2025-04-22 22:54:00.913586+00",
      "attributes": {
        "name": {
          "match_resolution": true,
          "values": [
            "VTB Bank"
          ]
        },
        "country": {
          "match_resolution": true,
          "values": [
            "RUS"
          ]
        },
        "address": {
          "match_resolution": true,
          "values": [
            "Moscow"
          ]
        },
        "identifier": {
          "match_resolution": true,
          "values": [
            "253400V1H6ART1UQ0N98"
          ]
        }
      },
      "countries": [
        "USA",
        "CYP",
        "ITA",
        "CHN",
        "RUS",
        "UKR",
        "IND",
        "IRL",
        "KAZ",
        "DEU"
      ],
      "risk_categories": [
        {
          "id": "regulatory_action",
          "label": "Regulatory action",
          "risk_factors": [
            "regulatory_action"
          ]
        },
        {
          "id": "export_controls",
          "label": "Export controls",
          "risk_factors": [
            "meu_list_contractors",
            "export_controls"
          ]
        },
        {
          "id": "political_exposure",
          "label": "Political exposure",
          "risk_factors": [
            "soe_adjacent",
            "pep_adjacent"
          ]
        },
        {
          "id": "sanctions",
          "label": "Sanctions",
          "risk_factors": [
            "sanctioned",
            "formerly_sanctioned"
          ]
        },
        {
          "id": "adverse_media",
          "label": "Adverse media",
          "risk_factors": [
            "reputational_risk_other"
          ]
        }
      ],
      "risk_factors": [
        {
          "id": "regulatory_action"
        },
        {
          "id": "sanctioned"
        },
        {
          "id": "meu_list_contractors"
        },
        {
          "id": "reputational_risk_other"
        },
        {
          "id": "pep_adjacent"
        },
        {
          "id": "state_owned"
        },
        {
          "id": "export_controls"
        },
        {
          "id": "formerly_sanctioned"
        },
        {
          "id": "basel_aml"
        },
        {
          "id": "cpi_score"
        }
      ],
      "upstream": {
        "risk_factors": [],
        "countries": [],
        "trade_counts": {
          "receiver_of": 2,
          "shipper_of": 56
        },
        "has_upstream": false,
        "products": []
      },
      "tags": [],
      "matches": [
        {
          "match_id": "52z4Wa:dy-rh2g0QtzUN_jC_e9S_A",
          "sayari_entity_id": "dy-rh2g0QtzUN_jC_e9S_A",
          "type": "company",
          "label": "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"РОССИЙСКИЕ ЖЕЛЕЗНЫЕ ДОРОГИ\"",
          "countries": [
            "USA",
            "CYP",
            "ITA",
            "CHN",
            "RUS",
            "UKR",
            "IND",
            "IRL",
            "KAZ",
            "DEU"
          ],
          "risk_categories": [
            {
              "id": "regulatory_action",
              "label": "Regulatory action",
              "risk_factors": [
                "regulatory_action"
              ]
            },
            {
              "id": "export_controls",
              "label": "Export controls",
              "risk_factors": [
                "meu_list_contractors",
                "export_controls"
              ]
            },
            {
              "id": "political_exposure",
              "label": "Political exposure",
              "risk_factors": [
                "soe_adjacent",
                "pep_adjacent"
              ]
            },
            {
              "id": "sanctions",
              "label": "Sanctions",
              "risk_factors": [
                "sanctioned",
                "formerly_sanctioned"
              ]
            },
            {
              "id": "adverse_media",
              "label": "Adverse media",
              "risk_factors": [
                "reputational_risk_other"
              ]
            }
          ],
          "risk_factors": [
            {
              "id": "regulatory_action"
            },
            {
              "id": "sanctioned"
            },
            {
              "id": "meu_list_contractors"
            },
            {
              "id": "reputational_risk_other"
            },
            {
              "id": "pep_adjacent"
            },
            {
              "id": "state_owned"
            },
            {
              "id": "export_controls"
            },
            {
              "id": "formerly_sanctioned"
            },
            {
              "id": "basel_aml"
            },
            {
              "id": "cpi_score"
            }
          ],
          "business_purpose": [
            {
              "code": "6419",
              "standard": "ISIC4"
            },
            {
              "code": "64.19",
              "standard": "unknown"
            },
            {
              "code": "64.9",
              "standard": "unknown"
            },
            {
              "code": "62.09",
              "standard": "unknown"
            },
            {
              "code": "64.19",
              "standard": "NACE2"
            },
            {
              "code": "64.19",
              "standard": "unknown"
            },
            {
              "code": "649",
              "standard": "ISIC4"
            },
            {
              "code": "66.12",
              "standard": "unknown"
            },
            {
              "code": "6419",
              "standard": "ISIC4"
            },
            {
              "code": "6209",
              "standard": "ISIC4"
            },
            {
              "code": "6612",
              "standard": "ISIC4"
            }
          ],
          "upstream": {
            "risk_factors": [],
            "countries": [],
            "trade_counts": {
              "receiver_of": 2,
              "shipper_of": 56
            },
            "has_upstream": false,
            "products": []
          },
          "sources": [
            {
              "id": "eb361ba33d05a9d15b2d28aea739362a",
              "label": "USA SEC Central Index Key Database"
            },
            {
              "id": "a8c6ee1cd4dfc952105ee8c0e4836f08",
              "label": "Acuris Risk Intelligence KYC6 (3rd Party Data)"
            },
            {
              "id": "3322a755c28851ec06eda3280cc2a2b2",
              "label": "Russia ClearSpending (3rd Party Data)"
            },
            {
              "id": "93de05b55a68cc964f34bbfc7ec7bc86",
              "label": "Consolidated Canadian Autonomous Sanctions List"
            },
            {
              "id": "fdfedf11a5122e2aef9dc3f176c7427d",
              "label": "Sayari Intel (Sayari Curated Risk Data) - Archived"
            },
            {
              "id": "e517c714b560f159a89a9501ed7dd84e",
              "label": "Infocredit Cyprus Company Shareholders Database (3rd Party Data)"
            },
            {
              "id": "bef2f30139ea37c723ecb0f953b5f024",
              "label": "Australia Consolidated Sanctions List"
            },
            {
              "id": "9048153c770d941afe9500c6ad810a80",
              "label": "Kazakhstan DFO Registry"
            },
            {
              "id": "635021e4e01979cdf95fa7ee76501696",
              "label": "Russia E-Disclosures"
            },
            {
              "id": "e85d865943ee6d8369307569d2ad9de0",
              "label": "Acuris Risk Intelligence Adverse Media Data"
            },
            {
              "id": "4ff85397f508e4ff8e71c5ca5ea895dd",
              "label": "Japan Ministry of Finance Economic Sanctions List"
            },
            {
              "id": "ce873f184abee5b13c9e89791bd78229",
              "label": "Ukraine Significant Shareholders of Securities Issuers"
            },
            {
              "id": "8511f57f6098dcc36e3a814c3ea5bdd7",
              "label": "Uzbekistan Imports & Exports (January 2022 - Present)"
            },
            {
              "id": "e6e4acebdea4e9e71af8d3586d34fcdd",
              "label": "Ukraine Sanctions List"
            },
            {
              "id": "db3416894cd5f0c4d2d6ecc79bdaf366",
              "label": "EDI Publicly-Listed Global Security Issuers (3rd Party Data)"
            },
            {
              "id": "b812677c0a32a1746b3ac741c7b97ae0",
              "label": "Legal Entity Identifier (LEI) Registry (3rd Party Data)"
            },
            {
              "id": "a9a18eeb901e4376c912e95dc05ceb78",
              "label": "Russia Federal Tax Registry"
            },
            {
              "id": "d357238101a2bb02d97d5d77a56d9455",
              "label": "New Zealand Russia Sanctions"
            },
            {
              "id": "f4ce10ac8bdc0bd9bcb31cb868b4b539",
              "label": "EU Financial Sanctions List"
            },
            {
              "id": "c10d482320f207d92aa814519c3bd686",
              "label": "UK Consolidated Sanctions List"
            },
            {
              "id": "d1bce737c158efddbef5048d63aaf124",
              "label": "Ukraine Ministry of Justice Registry of Companies"
            },
            {
              "id": "92edb8fe6615498f6e3e7b0e220f74e6",
              "label": "USA Treasury OFAC Specially Designated Nationals (SDN) List"
            },
            {
              "id": "66dfefb726ae00fde8f09f34c5578d35",
              "label": "Russia Imports & Exports (January 2023 - Present)"
            },
            {
              "id": "ad6dc774c74b92159422deabc5aee661",
              "label": "France National Asset Freeze Register"
            },
            {
              "id": "b97ad5c858093e5227b2359a0078696f",
              "label": "USA SAM.gov Entity Exclusions Database"
            },
            {
              "id": "ddbf93a5c5d568ccdb0c2455f7ecbfc8",
              "label": "USA CorpWatch SEC 10-K Exhibit 21 Database (3rd Party Data)"
            },
            {
              "id": "52a7bc4a30e787544ad2d95e7f54adca",
              "label": "USA OFAC Non-SDN Consolidated Sanctions List"
            },
            {
              "id": "f43658cf2a19452fb45b830edeeeea44",
              "label": "Russia Central Bank Financial Institution UBO Disclosures"
            },
            {
              "id": "828f81c7c31410de845d9e6ed1a0f3e6",
              "label": "Russia Central Bank Financial Institutions"
            },
            {
              "id": "56bce0e008204712e302271ddd7b4fb1",
              "label": "Russia Federal Tax Registry (2018)"
            },
            {
              "id": "e0b32f41da3b4e6c75f1f7bf6fe1c9c5",
              "label": "S&P Global Market Intelligence Database (3rd Party Data)"
            },
            {
              "id": "10a889609ddae6cc31773feebe48166b",
              "label": "Switzerland SECO Sanctions List"
            },
            {
              "id": "ded706ef28cdc649b6fc5142bc542890",
              "label": "EU Sanctions Map"
            },
            {
              "id": "417400a1ac439843fda5bb2f05fb4161",
              "label": "USA Consolidated Screening List"
            },
            {
              "id": "765d0dc816bb7db35031c43a37290350",
              "label": "Ireland Companies Registration Office Database"
            }
          ],
          "addresses": [
            {
              "value": "190000, г Санкт-Петербург, ул Большая Морская, дом 29"
            },
            {
              "value": "109147 г. Москва, ул. Воронцовская, д.43 стр.1"
            },
            {
              "value": "119121 г. Москва, ул. Плющиха, д. 37."
            },
            {
              "value": "43, Vorontsovskaya str., Moscow, 109044, Russia"
            },
            {
              "value": "11, lit A, Degtyarnyy pereulok, St. Petersburg, 191144, Russia"
            },
            {
              "value": "29, Bolshaya Morskaya str., St. Petersburg, 190000, Russia"
            }
          ],
          "hs_codes": [
            "847150",
            "8471500000",
            "852351",
            "8523519101",
            "860610",
            "8606100000",
            "271019",
            "2710196601",
            "490700",
            "4907003000",
            "711890",
            "7118900000",
            "490700",
            "4907003000",
            "711890",
            "7118900000"
          ],
          "created_at": "2025-04-22 22:54:00.913586+00",
          "updated_at": "2025-04-22 22:54:00.913586+00",
          "match_explanation": [
            {
              "field": "name",
              "quality": "high",
              "matches": [
                "<em>БАНК</em> <em>ВТБ</em> (ПАО)",
                "<em>VTB</em> <em>BANK</em> (PJSC)",
                "<em>БАНК</em> <em>ВТБ</em> (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)",
                "<em>VTB</em> <em>BANK</em> (PUBLIC JOINT STOCK COMPANY)",
                "<em>VTB</em> <em>Bank</em>"
              ]
            },
            {
              "field": "address",
              "quality": "medium",
              "matches": [
                "109147 <em>Moscow</em>, st. Vorontsovskaya, 43 building 1",
                "119121 <em>Moscow</em>, st. Plyushchikha, 37.",
                "Vorontsovskaya Str., 43 <em>Moscow</em> 109044 RUSSIAN FEDERATION",
                "37 Plyushchikha ul., <em>Moscow</em>, 119121, Russia",
                "Bashnya Zapad, Kompleks Federatsiya, 12, nab. Presnenskaya, <em>Moscow</em>, 123317, Russia"
              ]
            },
            {
              "field": "country",
              "quality": "high",
              "matches": [
                "<em>RUS</em>"
              ]
            },
            {
              "field": "identifier",
              "quality": "high",
              "matches": [
                "<em>253400V1H6ART1UQ0N98</em>"
              ]
            }
          ]
        }
      ],
      "case": {
        "id": "YZB88Y",
        "status": "not_assigned",
        "created_at": "2025-10-02"
      },
      "updated_at": "2025-04-23 13:37:00.215522+00",
      "updated_by": "auth0|5e45bd8caccd890e68147513"
    }
  ],
  "size": {
    "count": 1,
    "qualifier": "eq"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.sayari.com/v1/projects/YVB88Y/entities"

headers = {"Authorization": "<token>."}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.sayari.com/v1/projects/YVB88Y/entities';
const options = {method: 'GET', headers: {Authorization: '<token>.'}};

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"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<token>.")

	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")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<token>.'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.sayari.com/v1/projects/YVB88Y/entities")
  .header("Authorization", "<token>.")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.sayari.com/v1/projects/YVB88Y/entities', [
  'headers' => [
    'Authorization' => '<token>.',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.sayari.com/v1/projects/YVB88Y/entities");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "<token>.");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "<token>."]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.sayari.com/v1/projects/YVB88Y/entities")! 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()
```

### Example 2

**Response**

```json
{
  "limit": 20,
  "data": [
    {
      "project_entity_id": "52z4Wa",
      "project_id": "YVB88Y",
      "label": "VTB Bank",
      "upload_ids": [],
      "strength": "strong",
      "created_at": "2025-04-22 22:54:00.913586+00",
      "attributes": {
        "name": {
          "match_resolution": true,
          "values": [
            "VTB Bank"
          ]
        },
        "country": {
          "match_resolution": true,
          "values": [
            "RUS"
          ]
        },
        "address": {
          "match_resolution": true,
          "values": [
            "Moscow"
          ]
        },
        "identifier": {
          "match_resolution": true,
          "values": [
            "253400V1H6ART1UQ0N98"
          ]
        }
      },
      "countries": [
        "USA",
        "CYP",
        "ITA",
        "CHN",
        "RUS",
        "UKR",
        "IND",
        "IRL",
        "KAZ",
        "DEU"
      ],
      "risk_categories": [
        {
          "id": "regulatory_action",
          "label": "Regulatory action",
          "risk_factors": [
            "regulatory_action"
          ]
        },
        {
          "id": "export_controls",
          "label": "Export controls",
          "risk_factors": [
            "meu_list_contractors",
            "export_controls"
          ]
        },
        {
          "id": "political_exposure",
          "label": "Political exposure",
          "risk_factors": [
            "soe_adjacent",
            "pep_adjacent"
          ]
        },
        {
          "id": "sanctions",
          "label": "Sanctions",
          "risk_factors": [
            "sanctioned",
            "formerly_sanctioned"
          ]
        },
        {
          "id": "adverse_media",
          "label": "Adverse media",
          "risk_factors": [
            "reputational_risk_other"
          ]
        }
      ],
      "risk_factors": [
        {
          "id": "regulatory_action"
        },
        {
          "id": "sanctioned"
        },
        {
          "id": "meu_list_contractors"
        },
        {
          "id": "reputational_risk_other"
        },
        {
          "id": "pep_adjacent"
        },
        {
          "id": "state_owned"
        },
        {
          "id": "export_controls"
        },
        {
          "id": "formerly_sanctioned"
        },
        {
          "id": "basel_aml"
        },
        {
          "id": "cpi_score"
        }
      ],
      "upstream": {
        "risk_factors": [],
        "countries": [],
        "trade_counts": {
          "receiver_of": 2,
          "shipper_of": 56
        },
        "has_upstream": false,
        "products": []
      },
      "tags": [],
      "matches": [
        {
          "match_id": "52z4Wa:dy-rh2g0QtzUN_jC_e9S_A",
          "sayari_entity_id": "dy-rh2g0QtzUN_jC_e9S_A",
          "type": "company",
          "label": "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"РОССИЙСКИЕ ЖЕЛЕЗНЫЕ ДОРОГИ\"",
          "countries": [
            "USA",
            "CYP",
            "ITA",
            "CHN",
            "RUS",
            "UKR",
            "IND",
            "IRL",
            "KAZ",
            "DEU"
          ],
          "risk_categories": [
            {
              "id": "regulatory_action",
              "label": "Regulatory action",
              "risk_factors": [
                "regulatory_action"
              ]
            },
            {
              "id": "export_controls",
              "label": "Export controls",
              "risk_factors": [
                "meu_list_contractors",
                "export_controls"
              ]
            },
            {
              "id": "political_exposure",
              "label": "Political exposure",
              "risk_factors": [
                "soe_adjacent",
                "pep_adjacent"
              ]
            },
            {
              "id": "sanctions",
              "label": "Sanctions",
              "risk_factors": [
                "sanctioned",
                "formerly_sanctioned"
              ]
            },
            {
              "id": "adverse_media",
              "label": "Adverse media",
              "risk_factors": [
                "reputational_risk_other"
              ]
            }
          ],
          "risk_factors": [
            {
              "id": "regulatory_action"
            },
            {
              "id": "sanctioned"
            },
            {
              "id": "meu_list_contractors"
            },
            {
              "id": "reputational_risk_other"
            },
            {
              "id": "pep_adjacent"
            },
            {
              "id": "state_owned"
            },
            {
              "id": "export_controls"
            },
            {
              "id": "formerly_sanctioned"
            },
            {
              "id": "basel_aml"
            },
            {
              "id": "cpi_score"
            }
          ],
          "business_purpose": [
            {
              "code": "6419",
              "standard": "ISIC4"
            },
            {
              "code": "64.19",
              "standard": "unknown"
            },
            {
              "code": "64.9",
              "standard": "unknown"
            },
            {
              "code": "62.09",
              "standard": "unknown"
            },
            {
              "code": "64.19",
              "standard": "NACE2"
            },
            {
              "code": "64.19",
              "standard": "unknown"
            },
            {
              "code": "649",
              "standard": "ISIC4"
            },
            {
              "code": "66.12",
              "standard": "unknown"
            },
            {
              "code": "6419",
              "standard": "ISIC4"
            },
            {
              "code": "6209",
              "standard": "ISIC4"
            },
            {
              "code": "6612",
              "standard": "ISIC4"
            }
          ],
          "upstream": {
            "risk_factors": [],
            "countries": [],
            "trade_counts": {
              "receiver_of": 2,
              "shipper_of": 56
            },
            "has_upstream": false,
            "products": []
          },
          "sources": [
            {
              "id": "eb361ba33d05a9d15b2d28aea739362a",
              "label": "USA SEC Central Index Key Database"
            },
            {
              "id": "a8c6ee1cd4dfc952105ee8c0e4836f08",
              "label": "Acuris Risk Intelligence KYC6 (3rd Party Data)"
            },
            {
              "id": "3322a755c28851ec06eda3280cc2a2b2",
              "label": "Russia ClearSpending (3rd Party Data)"
            },
            {
              "id": "93de05b55a68cc964f34bbfc7ec7bc86",
              "label": "Consolidated Canadian Autonomous Sanctions List"
            },
            {
              "id": "fdfedf11a5122e2aef9dc3f176c7427d",
              "label": "Sayari Intel (Sayari Curated Risk Data) - Archived"
            },
            {
              "id": "e517c714b560f159a89a9501ed7dd84e",
              "label": "Infocredit Cyprus Company Shareholders Database (3rd Party Data)"
            },
            {
              "id": "bef2f30139ea37c723ecb0f953b5f024",
              "label": "Australia Consolidated Sanctions List"
            },
            {
              "id": "9048153c770d941afe9500c6ad810a80",
              "label": "Kazakhstan DFO Registry"
            },
            {
              "id": "635021e4e01979cdf95fa7ee76501696",
              "label": "Russia E-Disclosures"
            },
            {
              "id": "e85d865943ee6d8369307569d2ad9de0",
              "label": "Acuris Risk Intelligence Adverse Media Data"
            },
            {
              "id": "4ff85397f508e4ff8e71c5ca5ea895dd",
              "label": "Japan Ministry of Finance Economic Sanctions List"
            },
            {
              "id": "ce873f184abee5b13c9e89791bd78229",
              "label": "Ukraine Significant Shareholders of Securities Issuers"
            },
            {
              "id": "8511f57f6098dcc36e3a814c3ea5bdd7",
              "label": "Uzbekistan Imports & Exports (January 2022 - Present)"
            },
            {
              "id": "e6e4acebdea4e9e71af8d3586d34fcdd",
              "label": "Ukraine Sanctions List"
            },
            {
              "id": "db3416894cd5f0c4d2d6ecc79bdaf366",
              "label": "EDI Publicly-Listed Global Security Issuers (3rd Party Data)"
            },
            {
              "id": "b812677c0a32a1746b3ac741c7b97ae0",
              "label": "Legal Entity Identifier (LEI) Registry (3rd Party Data)"
            },
            {
              "id": "a9a18eeb901e4376c912e95dc05ceb78",
              "label": "Russia Federal Tax Registry"
            },
            {
              "id": "d357238101a2bb02d97d5d77a56d9455",
              "label": "New Zealand Russia Sanctions"
            },
            {
              "id": "f4ce10ac8bdc0bd9bcb31cb868b4b539",
              "label": "EU Financial Sanctions List"
            },
            {
              "id": "c10d482320f207d92aa814519c3bd686",
              "label": "UK Consolidated Sanctions List"
            },
            {
              "id": "d1bce737c158efddbef5048d63aaf124",
              "label": "Ukraine Ministry of Justice Registry of Companies"
            },
            {
              "id": "92edb8fe6615498f6e3e7b0e220f74e6",
              "label": "USA Treasury OFAC Specially Designated Nationals (SDN) List"
            },
            {
              "id": "66dfefb726ae00fde8f09f34c5578d35",
              "label": "Russia Imports & Exports (January 2023 - Present)"
            },
            {
              "id": "ad6dc774c74b92159422deabc5aee661",
              "label": "France National Asset Freeze Register"
            },
            {
              "id": "b97ad5c858093e5227b2359a0078696f",
              "label": "USA SAM.gov Entity Exclusions Database"
            },
            {
              "id": "ddbf93a5c5d568ccdb0c2455f7ecbfc8",
              "label": "USA CorpWatch SEC 10-K Exhibit 21 Database (3rd Party Data)"
            },
            {
              "id": "52a7bc4a30e787544ad2d95e7f54adca",
              "label": "USA OFAC Non-SDN Consolidated Sanctions List"
            },
            {
              "id": "f43658cf2a19452fb45b830edeeeea44",
              "label": "Russia Central Bank Financial Institution UBO Disclosures"
            },
            {
              "id": "828f81c7c31410de845d9e6ed1a0f3e6",
              "label": "Russia Central Bank Financial Institutions"
            },
            {
              "id": "56bce0e008204712e302271ddd7b4fb1",
              "label": "Russia Federal Tax Registry (2018)"
            },
            {
              "id": "e0b32f41da3b4e6c75f1f7bf6fe1c9c5",
              "label": "S&P Global Market Intelligence Database (3rd Party Data)"
            },
            {
              "id": "10a889609ddae6cc31773feebe48166b",
              "label": "Switzerland SECO Sanctions List"
            },
            {
              "id": "ded706ef28cdc649b6fc5142bc542890",
              "label": "EU Sanctions Map"
            },
            {
              "id": "417400a1ac439843fda5bb2f05fb4161",
              "label": "USA Consolidated Screening List"
            },
            {
              "id": "765d0dc816bb7db35031c43a37290350",
              "label": "Ireland Companies Registration Office Database"
            }
          ],
          "addresses": [
            {
              "value": "190000, г Санкт-Петербург, ул Большая Морская, дом 29"
            },
            {
              "value": "109147 г. Москва, ул. Воронцовская, д.43 стр.1"
            },
            {
              "value": "119121 г. Москва, ул. Плющиха, д. 37."
            },
            {
              "value": "43, Vorontsovskaya str., Moscow, 109044, Russia"
            },
            {
              "value": "11, lit A, Degtyarnyy pereulok, St. Petersburg, 191144, Russia"
            },
            {
              "value": "29, Bolshaya Morskaya str., St. Petersburg, 190000, Russia"
            }
          ],
          "hs_codes": [
            "847150",
            "8471500000",
            "852351",
            "8523519101",
            "860610",
            "8606100000",
            "271019",
            "2710196601",
            "490700",
            "4907003000",
            "711890",
            "7118900000",
            "490700",
            "4907003000",
            "711890",
            "7118900000"
          ],
          "created_at": "2025-04-22 22:54:00.913586+00",
          "updated_at": "2025-04-22 22:54:00.913586+00",
          "match_explanation": [
            {
              "field": "name",
              "quality": "high",
              "matches": [
                "<em>БАНК</em> <em>ВТБ</em> (ПАО)",
                "<em>VTB</em> <em>BANK</em> (PJSC)",
                "<em>БАНК</em> <em>ВТБ</em> (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)",
                "<em>VTB</em> <em>BANK</em> (PUBLIC JOINT STOCK COMPANY)",
                "<em>VTB</em> <em>Bank</em>"
              ]
            },
            {
              "field": "address",
              "quality": "medium",
              "matches": [
                "109147 <em>Moscow</em>, st. Vorontsovskaya, 43 building 1",
                "119121 <em>Moscow</em>, st. Plyushchikha, 37.",
                "Vorontsovskaya Str., 43 <em>Moscow</em> 109044 RUSSIAN FEDERATION",
                "37 Plyushchikha ul., <em>Moscow</em>, 119121, Russia",
                "Bashnya Zapad, Kompleks Federatsiya, 12, nab. Presnenskaya, <em>Moscow</em>, 123317, Russia"
              ]
            },
            {
              "field": "country",
              "quality": "high",
              "matches": [
                "<em>RUS</em>"
              ]
            },
            {
              "field": "identifier",
              "quality": "high",
              "matches": [
                "<em>253400V1H6ART1UQ0N98</em>"
              ]
            }
          ]
        }
      ],
      "case": {
        "id": "YZB88Y",
        "status": "not_assigned",
        "created_at": "2025-10-02"
      },
      "updated_at": "2025-04-23 13:37:00.215522+00",
      "updated_by": "auth0|5e45bd8caccd890e68147513"
    }
  ],
  "size": {
    "count": 1,
    "qualifier": "eq"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.sayari.com/v1/projects/YVB88Y/entities"

querystring = {"limit":"10","filter":"{\"risk_factor\":[\"sanctioned\",\"regulatory_action\"],\"country\":[\"RUS\",\"CHN\"],\"match_strength\":[\"strong\",\"partial\"],\"case_status\":[\"not_assigned\"],\"label\":{\"fuzzy\":[\"bank\",\"financial\"]},\"business_purpose\":[\"6419\",\"banking\"],\"tag\":[\"high-risk\",\"sanctions-review\"]}"}

headers = {"Authorization": "<token>."}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.sayari.com/v1/projects/YVB88Y/entities?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%22%5D%7D';
const options = {method: 'GET', headers: {Authorization: '<token>.'}};

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?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%22%5D%7D"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<token>.")

	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?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%22%5D%7D")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<token>.'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.sayari.com/v1/projects/YVB88Y/entities?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%22%5D%7D")
  .header("Authorization", "<token>.")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.sayari.com/v1/projects/YVB88Y/entities?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%22%5D%7D', [
  'headers' => [
    'Authorization' => '<token>.',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.sayari.com/v1/projects/YVB88Y/entities?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%22%5D%7D");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "<token>.");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "<token>."]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.sayari.com/v1/projects/YVB88Y/entities?limit=10&filter=%7B%22risk_factor%22%3A%5B%22sanctioned%22%2C%22regulatory_action%22%5D%2C%22country%22%3A%5B%22RUS%22%2C%22CHN%22%5D%2C%22match_strength%22%3A%5B%22strong%22%2C%22partial%22%5D%2C%22case_status%22%3A%5B%22not_assigned%22%5D%2C%22label%22%3A%7B%22fuzzy%22%3A%5B%22bank%22%2C%22financial%22%5D%7D%2C%22business_purpose%22%3A%5B%226419%22%2C%22banking%22%5D%2C%22tag%22%3A%5B%22high-risk%22%2C%22sanctions-review%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()
```

### Example 3

**Response**

```json
{
  "limit": 20,
  "data": [
    {
      "project_entity_id": "52z4Wa",
      "project_id": "YVB88Y",
      "label": "VTB Bank",
      "upload_ids": [],
      "strength": "strong",
      "created_at": "2025-04-22 22:54:00.913586+00",
      "attributes": {
        "name": {
          "match_resolution": true,
          "values": [
            "VTB Bank"
          ]
        },
        "country": {
          "match_resolution": true,
          "values": [
            "RUS"
          ]
        },
        "address": {
          "match_resolution": true,
          "values": [
            "Moscow"
          ]
        },
        "identifier": {
          "match_resolution": true,
          "values": [
            "253400V1H6ART1UQ0N98"
          ]
        }
      },
      "countries": [
        "USA",
        "CYP",
        "ITA",
        "CHN",
        "RUS",
        "UKR",
        "IND",
        "IRL",
        "KAZ",
        "DEU"
      ],
      "risk_categories": [
        {
          "id": "regulatory_action",
          "label": "Regulatory action",
          "risk_factors": [
            "regulatory_action"
          ]
        },
        {
          "id": "export_controls",
          "label": "Export controls",
          "risk_factors": [
            "meu_list_contractors",
            "export_controls"
          ]
        },
        {
          "id": "political_exposure",
          "label": "Political exposure",
          "risk_factors": [
            "soe_adjacent",
            "pep_adjacent"
          ]
        },
        {
          "id": "sanctions",
          "label": "Sanctions",
          "risk_factors": [
            "sanctioned",
            "formerly_sanctioned"
          ]
        },
        {
          "id": "adverse_media",
          "label": "Adverse media",
          "risk_factors": [
            "reputational_risk_other"
          ]
        }
      ],
      "risk_factors": [
        {
          "id": "regulatory_action"
        },
        {
          "id": "sanctioned"
        },
        {
          "id": "meu_list_contractors"
        },
        {
          "id": "reputational_risk_other"
        },
        {
          "id": "pep_adjacent"
        },
        {
          "id": "state_owned"
        },
        {
          "id": "export_controls"
        },
        {
          "id": "formerly_sanctioned"
        },
        {
          "id": "basel_aml"
        },
        {
          "id": "cpi_score"
        }
      ],
      "upstream": {
        "risk_factors": [],
        "countries": [],
        "trade_counts": {
          "receiver_of": 2,
          "shipper_of": 56
        },
        "has_upstream": false,
        "products": []
      },
      "tags": [],
      "matches": [
        {
          "match_id": "52z4Wa:dy-rh2g0QtzUN_jC_e9S_A",
          "sayari_entity_id": "dy-rh2g0QtzUN_jC_e9S_A",
          "type": "company",
          "label": "ОТКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"РОССИЙСКИЕ ЖЕЛЕЗНЫЕ ДОРОГИ\"",
          "countries": [
            "USA",
            "CYP",
            "ITA",
            "CHN",
            "RUS",
            "UKR",
            "IND",
            "IRL",
            "KAZ",
            "DEU"
          ],
          "risk_categories": [
            {
              "id": "regulatory_action",
              "label": "Regulatory action",
              "risk_factors": [
                "regulatory_action"
              ]
            },
            {
              "id": "export_controls",
              "label": "Export controls",
              "risk_factors": [
                "meu_list_contractors",
                "export_controls"
              ]
            },
            {
              "id": "political_exposure",
              "label": "Political exposure",
              "risk_factors": [
                "soe_adjacent",
                "pep_adjacent"
              ]
            },
            {
              "id": "sanctions",
              "label": "Sanctions",
              "risk_factors": [
                "sanctioned",
                "formerly_sanctioned"
              ]
            },
            {
              "id": "adverse_media",
              "label": "Adverse media",
              "risk_factors": [
                "reputational_risk_other"
              ]
            }
          ],
          "risk_factors": [
            {
              "id": "regulatory_action"
            },
            {
              "id": "sanctioned"
            },
            {
              "id": "meu_list_contractors"
            },
            {
              "id": "reputational_risk_other"
            },
            {
              "id": "pep_adjacent"
            },
            {
              "id": "state_owned"
            },
            {
              "id": "export_controls"
            },
            {
              "id": "formerly_sanctioned"
            },
            {
              "id": "basel_aml"
            },
            {
              "id": "cpi_score"
            }
          ],
          "business_purpose": [
            {
              "code": "6419",
              "standard": "ISIC4"
            },
            {
              "code": "64.19",
              "standard": "unknown"
            },
            {
              "code": "64.9",
              "standard": "unknown"
            },
            {
              "code": "62.09",
              "standard": "unknown"
            },
            {
              "code": "64.19",
              "standard": "NACE2"
            },
            {
              "code": "64.19",
              "standard": "unknown"
            },
            {
              "code": "649",
              "standard": "ISIC4"
            },
            {
              "code": "66.12",
              "standard": "unknown"
            },
            {
              "code": "6419",
              "standard": "ISIC4"
            },
            {
              "code": "6209",
              "standard": "ISIC4"
            },
            {
              "code": "6612",
              "standard": "ISIC4"
            }
          ],
          "upstream": {
            "risk_factors": [],
            "countries": [],
            "trade_counts": {
              "receiver_of": 2,
              "shipper_of": 56
            },
            "has_upstream": false,
            "products": []
          },
          "sources": [
            {
              "id": "eb361ba33d05a9d15b2d28aea739362a",
              "label": "USA SEC Central Index Key Database"
            },
            {
              "id": "a8c6ee1cd4dfc952105ee8c0e4836f08",
              "label": "Acuris Risk Intelligence KYC6 (3rd Party Data)"
            },
            {
              "id": "3322a755c28851ec06eda3280cc2a2b2",
              "label": "Russia ClearSpending (3rd Party Data)"
            },
            {
              "id": "93de05b55a68cc964f34bbfc7ec7bc86",
              "label": "Consolidated Canadian Autonomous Sanctions List"
            },
            {
              "id": "fdfedf11a5122e2aef9dc3f176c7427d",
              "label": "Sayari Intel (Sayari Curated Risk Data) - Archived"
            },
            {
              "id": "e517c714b560f159a89a9501ed7dd84e",
              "label": "Infocredit Cyprus Company Shareholders Database (3rd Party Data)"
            },
            {
              "id": "bef2f30139ea37c723ecb0f953b5f024",
              "label": "Australia Consolidated Sanctions List"
            },
            {
              "id": "9048153c770d941afe9500c6ad810a80",
              "label": "Kazakhstan DFO Registry"
            },
            {
              "id": "635021e4e01979cdf95fa7ee76501696",
              "label": "Russia E-Disclosures"
            },
            {
              "id": "e85d865943ee6d8369307569d2ad9de0",
              "label": "Acuris Risk Intelligence Adverse Media Data"
            },
            {
              "id": "4ff85397f508e4ff8e71c5ca5ea895dd",
              "label": "Japan Ministry of Finance Economic Sanctions List"
            },
            {
              "id": "ce873f184abee5b13c9e89791bd78229",
              "label": "Ukraine Significant Shareholders of Securities Issuers"
            },
            {
              "id": "8511f57f6098dcc36e3a814c3ea5bdd7",
              "label": "Uzbekistan Imports & Exports (January 2022 - Present)"
            },
            {
              "id": "e6e4acebdea4e9e71af8d3586d34fcdd",
              "label": "Ukraine Sanctions List"
            },
            {
              "id": "db3416894cd5f0c4d2d6ecc79bdaf366",
              "label": "EDI Publicly-Listed Global Security Issuers (3rd Party Data)"
            },
            {
              "id": "b812677c0a32a1746b3ac741c7b97ae0",
              "label": "Legal Entity Identifier (LEI) Registry (3rd Party Data)"
            },
            {
              "id": "a9a18eeb901e4376c912e95dc05ceb78",
              "label": "Russia Federal Tax Registry"
            },
            {
              "id": "d357238101a2bb02d97d5d77a56d9455",
              "label": "New Zealand Russia Sanctions"
            },
            {
              "id": "f4ce10ac8bdc0bd9bcb31cb868b4b539",
              "label": "EU Financial Sanctions List"
            },
            {
              "id": "c10d482320f207d92aa814519c3bd686",
              "label": "UK Consolidated Sanctions List"
            },
            {
              "id": "d1bce737c158efddbef5048d63aaf124",
              "label": "Ukraine Ministry of Justice Registry of Companies"
            },
            {
              "id": "92edb8fe6615498f6e3e7b0e220f74e6",
              "label": "USA Treasury OFAC Specially Designated Nationals (SDN) List"
            },
            {
              "id": "66dfefb726ae00fde8f09f34c5578d35",
              "label": "Russia Imports & Exports (January 2023 - Present)"
            },
            {
              "id": "ad6dc774c74b92159422deabc5aee661",
              "label": "France National Asset Freeze Register"
            },
            {
              "id": "b97ad5c858093e5227b2359a0078696f",
              "label": "USA SAM.gov Entity Exclusions Database"
            },
            {
              "id": "ddbf93a5c5d568ccdb0c2455f7ecbfc8",
              "label": "USA CorpWatch SEC 10-K Exhibit 21 Database (3rd Party Data)"
            },
            {
              "id": "52a7bc4a30e787544ad2d95e7f54adca",
              "label": "USA OFAC Non-SDN Consolidated Sanctions List"
            },
            {
              "id": "f43658cf2a19452fb45b830edeeeea44",
              "label": "Russia Central Bank Financial Institution UBO Disclosures"
            },
            {
              "id": "828f81c7c31410de845d9e6ed1a0f3e6",
              "label": "Russia Central Bank Financial Institutions"
            },
            {
              "id": "56bce0e008204712e302271ddd7b4fb1",
              "label": "Russia Federal Tax Registry (2018)"
            },
            {
              "id": "e0b32f41da3b4e6c75f1f7bf6fe1c9c5",
              "label": "S&P Global Market Intelligence Database (3rd Party Data)"
            },
            {
              "id": "10a889609ddae6cc31773feebe48166b",
              "label": "Switzerland SECO Sanctions List"
            },
            {
              "id": "ded706ef28cdc649b6fc5142bc542890",
              "label": "EU Sanctions Map"
            },
            {
              "id": "417400a1ac439843fda5bb2f05fb4161",
              "label": "USA Consolidated Screening List"
            },
            {
              "id": "765d0dc816bb7db35031c43a37290350",
              "label": "Ireland Companies Registration Office Database"
            }
          ],
          "addresses": [
            {
              "value": "190000, г Санкт-Петербург, ул Большая Морская, дом 29"
            },
            {
              "value": "109147 г. Москва, ул. Воронцовская, д.43 стр.1"
            },
            {
              "value": "119121 г. Москва, ул. Плющиха, д. 37."
            },
            {
              "value": "43, Vorontsovskaya str., Moscow, 109044, Russia"
            },
            {
              "value": "11, lit A, Degtyarnyy pereulok, St. Petersburg, 191144, Russia"
            },
            {
              "value": "29, Bolshaya Morskaya str., St. Petersburg, 190000, Russia"
            }
          ],
          "hs_codes": [
            "847150",
            "8471500000",
            "852351",
            "8523519101",
            "860610",
            "8606100000",
            "271019",
            "2710196601",
            "490700",
            "4907003000",
            "711890",
            "7118900000",
            "490700",
            "4907003000",
            "711890",
            "7118900000"
          ],
          "created_at": "2025-04-22 22:54:00.913586+00",
          "updated_at": "2025-04-22 22:54:00.913586+00",
          "match_explanation": [
            {
              "field": "name",
              "quality": "high",
              "matches": [
                "<em>БАНК</em> <em>ВТБ</em> (ПАО)",
                "<em>VTB</em> <em>BANK</em> (PJSC)",
                "<em>БАНК</em> <em>ВТБ</em> (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)",
                "<em>VTB</em> <em>BANK</em> (PUBLIC JOINT STOCK COMPANY)",
                "<em>VTB</em> <em>Bank</em>"
              ]
            },
            {
              "field": "address",
              "quality": "medium",
              "matches": [
                "109147 <em>Moscow</em>, st. Vorontsovskaya, 43 building 1",
                "119121 <em>Moscow</em>, st. Plyushchikha, 37.",
                "Vorontsovskaya Str., 43 <em>Moscow</em> 109044 RUSSIAN FEDERATION",
                "37 Plyushchikha ul., <em>Moscow</em>, 119121, Russia",
                "Bashnya Zapad, Kompleks Federatsiya, 12, nab. Presnenskaya, <em>Moscow</em>, 123317, Russia"
              ]
            },
            {
              "field": "country",
              "quality": "high",
              "matches": [
                "<em>RUS</em>"
              ]
            },
            {
              "field": "identifier",
              "quality": "high",
              "matches": [
                "<em>253400V1H6ART1UQ0N98</em>"
              ]
            }
          ]
        }
      ],
      "case": {
        "id": "YZB88Y",
        "status": "not_assigned",
        "created_at": "2025-10-02"
      },
      "updated_at": "2025-04-23 13:37:00.215522+00",
      "updated_by": "auth0|5e45bd8caccd890e68147513"
    }
  ],
  "size": {
    "count": 1,
    "qualifier": "eq"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.sayari.com/v1/projects/YVB88Y/entities"

querystring = {"limit":"25","filter":"{\"risk_category\":[\"sanctions\",\"export_controls\"],\"upstream_product\":[\"8536\",\"8544\"],\"shipment_country\":[\"CHN\",\"VNM\"],\"tier1_shipment_country\":[\"CHN\"],\"city\":{\"fuzzy\":[\"moscow\",\"beijing\"]},\"identifier\":{\"fuzzy\":[\"253400V1H6ART1UQ0N98\"]},\"source\":{\"exact\":[\"92edb8fe6615498f6e3e7b0e220f74e6\",\"c10d482320f207d92aa814519c3bd686\"]},\"status\":[\"active\"],\"bounds\":\"55.680357237879136|-71.53607290158526|41.10876347746233|-40.963927098414736\",\"match_entity_id\":[\"dy-rh2g0QtzUN_jC_e9S_A\"],\"entity_type\":[\"company\"],\"upload\":[\"upload_123\"],\"match_count\":\"one\"}"}

headers = {"Authorization": "<token>."}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.sayari.com/v1/projects/YVB88Y/entities?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%7D';
const options = {method: 'GET', headers: {Authorization: '<token>.'}};

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?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%7D"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<token>.")

	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?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%7D")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<token>.'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.sayari.com/v1/projects/YVB88Y/entities?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%7D")
  .header("Authorization", "<token>.")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.sayari.com/v1/projects/YVB88Y/entities?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%7D', [
  'headers' => [
    'Authorization' => '<token>.',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.sayari.com/v1/projects/YVB88Y/entities?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%7D");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "<token>.");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "<token>."]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.sayari.com/v1/projects/YVB88Y/entities?limit=25&filter=%7B%22risk_category%22%3A%5B%22sanctions%22%2C%22export_controls%22%5D%2C%22upstream_product%22%3A%5B%228536%22%2C%228544%22%5D%2C%22shipment_country%22%3A%5B%22CHN%22%2C%22VNM%22%5D%2C%22tier1_shipment_country%22%3A%5B%22CHN%22%5D%2C%22city%22%3A%7B%22fuzzy%22%3A%5B%22moscow%22%2C%22beijing%22%5D%7D%2C%22identifier%22%3A%7B%22fuzzy%22%3A%5B%22253400V1H6ART1UQ0N98%22%5D%7D%2C%22source%22%3A%7B%22exact%22%3A%5B%2292edb8fe6615498f6e3e7b0e220f74e6%22%2C%22c10d482320f207d92aa814519c3bd686%22%5D%7D%2C%22status%22%3A%5B%22active%22%5D%2C%22bounds%22%3A%2255.680357237879136%7C-71.53607290158526%7C41.10876347746233%7C-40.963927098414736%22%2C%22match_entity_id%22%3A%5B%22dy-rh2g0QtzUN_jC_e9S_A%22%5D%2C%22entity_type%22%3A%5B%22company%22%5D%2C%22upload%22%3A%5B%22upload_123%22%5D%2C%22match_count%22%3A%22one%22%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()
```