# CitedTravel

> Agent-readable travel facts for almost every country (currency, driving side and public holidays for all 195; plugs/voltage and emergency numbers for 192; tipping for 177) plus a visa/entry pilot (GB, US, JP passports). Every value has sources, license, a verbatim quote or source value, last_verified and a confidence score. REST API and remote MCP server; languages en, ja, zh-Hans, zh-Hant.

Key rules for agents:
- Relay citations and the `attribution` strings to users.
- Entry answers are decision support only: always show `advisory` and `official_links`; never present them as a go/no-go verdict.
- Verbatim `quotes` stay in their original language and are authoritative; translations (none yet) are unofficial.
- Entry answers: `status` can be `visa_free_with_requirements` (no visa, but another formality is required). Read `additional_requirements` (each item quoted from the official source; `certainty` is `required` or `check_official`) and never present a route as plain visa-free when it lists a required item.
- Change feed (`/v1/changes`): `changed_on` (= `detected_at`) is when our pipeline detected the change, not when the rule took effect; `effective_date` (only when an official source states it) and `change_reason` (`source_update`, `pipeline_fix`, `rule_change`, `new_coverage`) are null when unknown.
- Static facts need no key (60 req/min/IP). Entry and trip briefs need a free key (POST /v1/keys; 1,000 calls/month, 50 entry calls, 60/min) or an x402 payment. x402 is live: USDC on Base mainnet (eip155:8453), $0.005 static / $0.01 entry / $0.02 trip brief; settled payments are final, but undeliverable paid responses are refunded; each 402 names the Terms version (extensions.terms). Paid plans: Builder US$19/month (100,000 calls, 600/min) and Pro US$99/month (1,000,000 calls, 3,000/min) plus any tax, monthly, renewing until cancelled; subscribe at https://citedtravel.com/pricing/ or POST /v1/billing/checkout; manage or cancel at https://citedtravel.com/withdraw/ (Manage subscription) or POST /v1/billing/portal; VAT included for consumers in the EU, the EEA, the UK and Switzerland. Paid plans aren't available in every country: https://citedtravel.com/terms/#6-subscriptions.

## Who it's for
- [Travel industry](https://citedtravel.com/travel-industry/): apps, agencies, events and AI travel agents that answer travelers in their own name
- [International trade](https://citedtravel.com/international-trade/): the country facts behind a business trip (national holidays, currency, plugs, emergency numbers, driving side)

## Docs
- [Documentation](https://citedtravel.com/docs/): keys, languages, endpoints, MCP, x402 payments, limits
- [Pricing](https://citedtravel.com/pricing/): Free, Builder, Pro and x402 pay-per-call prices and limits
- [OpenAPI 3.1](https://citedtravel.com/openapi.json): full machine-readable spec
- [MCP endpoint](https://citedtravel.com/mcp): Streamable HTTP, read-only tools
- [Source register](https://citedtravel.com/v1/sources): licenses and attribution strings

## Country pages
- [Travel facts by country](https://citedtravel.com/countries/): one HTML page per country at `https://citedtravel.com/countries/{iso2 lowercase}/` (e.g. [Japan](https://citedtravel.com/countries/jp/)), with the same cited data as `/v1/countries/{CC}`: plug types, voltage, currency, emergency numbers, driving side, upcoming holidays, tipping and entry notes. Prefer the API for machine use.

## Examples
- [Japan power facts in Japanese](https://citedtravel.com/v1/countries/JP/power?lang=ja)
- [Adapter check GB to US](https://citedtravel.com/v1/power/compat?from=GB&to=US)
- [Japan holidays over New Year](https://citedtravel.com/v1/countries/JP/holidays?from=2026-12-20&to=2027-01-10)

## Optional
- [About](https://citedtravel.com/about/): what CitedTravel is; operated by Spanstream LLC (Sheridan, Wyoming, US); contact support@citedtravel.com
- [Editorial independence policy](https://citedtravel.com/editorial-policy/): sponsors never influence data, answers or rankings; API responses never contain sponsored content
- [Disclaimer](https://citedtravel.com/disclaimer/)
- [Terms of Service](https://citedtravel.com/terms/)
- [Privacy Notice](https://citedtravel.com/privacy/)
- [Support](https://citedtravel.com/support/): support@citedtravel.com; API keys, billing, refunds, data corrections
- [Sponsors](https://citedtravel.com/sponsors/): website and newsletter sponsorships (never in API, MCP or machine-readable output)