Skip to content

API & data

Published risk datasets, API examples and public MCP access, with source dates, coverage and reuse terms.

Salient One · https://salientone.eu/

Public datasets

These existing JSON and CSV distributions require no account or key. Each reference explains its fields, methods and limitations.

Public risk datasets, downloads and reference pages
DatasetDownloadsReference
Country riskPublished country scores, bands, indicators and evidence coverage. Country-level context, not an entity assessment.Map, method and reuse terms
Material country changesRecorded changes in published scores, bands and evidence groups. Unchanged recomputations are excluded.Country updates and RSS
Screening-source coverageConfigured sources, ingestion health and aggregate record counts. Coverage metadata, not a download of sanctions designations.Coverage, fields and citation
Source freshnessSource dates, successful ingestion and pipeline status. Pipeline health does not establish completeness.Sources and interpretation

The files carry their available dates, coverage and schema version. A retrieval or generation timestamp does not establish a new source release. Source-specific rights and attribution still apply; reuse guidance is below.

Examples

Both commands use public endpoints without credentials. They stop with an error on a failed HTTP response.

Fetch one country profile

No key is required. The JSON includes the published scorecard, source dates and coverage. Missing values remain distinct from observed zeroes.

curl --fail --show-error --silent \
  'https://salientone.eu/s1/scorecard/api/country/UKR'

Download the country-risk CSV

Save the existing CSV for a spreadsheet or local analysis. Retain its data_use and source_attribution fields, and consult the reference for source dates.

curl --fail --show-error --location \
  'https://salientone.eu/s1/data/country-risk-latest.csv' \
  --output 'salient-one-country-risk.csv'

Public MCP subset

Add this endpoint to a remote MCP client that supports Streamable HTTP. Authentication: none. The client handles protocol initialization.

https://salientone.eu/s1/mcp

Shared public allowance

All four MCP tools and the /api/public/ REST routes share one global allowance across all anonymous users: 10 data calls/minute, 100/day and 3,000/30 days. Switching clients or routes does not create a separate allowance. Initialization and tool discovery do not consume data calls. Respect Retry-After on a 429 response.

screen_sanctions
Indicative candidate matching against OFAC SDN, EU and UK lists. A no-match is not clearance.
get_governance
Six World Bank WGI governance dimensions, with year, scale and direction.
get_news_tone
GDELT news tone and article count for country-name coverage. Unavailable or incomplete windows remain explicit.
list_coverage
Permitted sources, dates, licences, attribution and exclusions.

This subset exposes OFAC SDN, EU and UK list screening, World Bank WGI and GDELT news tone. It does not expose the composite scorecard, CPI, EPI, FSI, RSF, UN or INFORM. Generated input and output schemas describe the exact contracts.

Supported endpoints

Append these paths to https://salientone.eu/s1. Public subset routes use the shared allowance above; account endpoints use the account limits below.

GET/scorecard/api/countriesPublic · no key

Supported countries, ISO codes and regions.

GET/scorecard/api/country/:isoPublic · no key

One published country scorecard, with source dates and coverage.

GET/api/country/:iso/pdf?format=pdfPublic · no key

Rendered country-scorecard PDF.

POST/mcpPublic · shared allowance

The four source-restricted tools, using Streamable HTTP.

GET/api/public/governance/:iso3Public · shared allowance

Six WGI dimensions with observation year, scale, direction and source rights.

GET/api/public/news-tone/:iso3?days=90Public · shared allowance

GDELT news tone and article coverage mentioning the country name, over 1–90 complete UTC days. Not a country-risk score.

POST/api/public/screenPublic · shared allowance

Indicative OFAC SDN, EU and UK list matches, with source availability and no saved search history.

GET/api/public/coveragePublic · shared allowance

Sources, dates, licences, attribution and exclusions for the public subset.

POST/scorecard/api/scorecardsSigned-in account or API key

Full scorecards for up to 50 ISO alpha-3 country codes.

POST/api/screenSigned-in account or API key

Screening against the configured sanctions and debarment sources.

POST/api/screen/pdfSigned-in account or API key

Rendered sanctions-screening result PDF.

GET/api/export/csvSigned-in account

Country-indicator export. The published public country-risk CSV is linked above.

GET/api/export/auditSigned-in account

Retained sanctions decision log as CSV.

POST/api/project-assessment/scopePublic · no key

Existing Social Impact scoping route: stateless IFC PS1–8 reference questions. See the separate Social Impact documentation below. 20 requests/minute per connecting IP.

Account access and limits

Bulk scorecards and authenticated screening accept a signed-in session or an API key in x-api-key or Authorization: Bearer. Account-only downloads require a session where labelled.

1 active key, 10 requests/minute, 100/day and 3,000/30 days per account. Document preparations: 30/30 days. Manage account keys or review access and limits.

Reuse and errors

Credit Salient One and the underlying publishers, and retain source dates, coverage, attribution and applicable licence or modification notices with reused evidence. Each file or result states its own terms. Source-specific guidance and the terms of use explain the limits.

A missing or unavailable value is not an observed zero. An indicative candidate match is not an identity finding, and a no-match is not clearance. Country-level evidence does not determine the risk of a particular entity.

400 indicates invalid input; 401 requires authentication; 403 can indicate a disallowed browser origin; 404 can indicate unavailable coverage; 429 requires waiting for Retry-After; 503 indicates temporary unavailability. Public subset responses can explicitly report unknown or not_covered. Do not replace these outcomes with empty or successful results.

The source-restricted REST/MCP endpoints accept only configured browser origins. The command-line examples above do not depend on browser CORS permissions.

Social Impact API reference

Project impact scoping belongs to the Social Impact tools. The OpenAPI 3.1 description and versioned framework reference document the existing public route and its questions. Results do not assign an IFC category or establish project compliance; saving and report exports require an account. Assessment tool and method.

Workspace navigation

Salient OneRisks