Developer platform · API v1

Build with the risk layer, keep the safety boundary visible.

Read destinations, create assessments, embed badges, or download the monthly country snapshot. Integrations must preserve source links, confidence, and the planning-aid disclaimer.

REST API

City and country data

GET /api/v1/countries/france
GET /api/v1/cities/france/paris
POST /api/v1/assessments

Read endpoints work without a key at a lower rate limit. Generate a key from a user dashboard for authenticated capacity.

Public dataset

Monthly country snapshot

GET /data/monthly-risk-index.csv

Includes the snapshot month, country, ISO code, region, baseline composite, tier, confidence, review date, and methodology version.

Visual badge

Destination score badge

<img src="https://www.travelriskcalculator.com/badge/france/paris.svg"
     alt="Paris travel risk">

The badge is a current presentation of stored destination data. Link it back to the full destination page for context.

Embeddable search

Risk lookup on your site

<iframe src="https://www.travelriskcalculator.com/embed"
        title="Travel Risk Calculator"></iframe>

Use a descriptive title and do not hide the source or disclaimer.

Integration rules

Rate limits

Anonymous assessment creation is intentionally conservative. HTTP 429 means wait for the bucket to reset.

No sensitive profiles

Do not send names, passport numbers, precise home addresses, medical records, or payment data.

Public result slugs

Assessment results are public by unguessable slug. Treat share URLs as sensitive links.

Truthful status

Do not reinterpret unavailable source data as a positive safety signal.