Orizn Visa API
> Visa requirements, fees, embassies, transit rules and more > for every passport / destination pair in the world — in 15 languages. The Orizn Visa API…
Logistics & shipping#transportation
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
> Visa requirements, fees, embassies, transit rules and more
> for every passport / destination pair in the world — in 15 languages.
The Orizn Visa API returns the full visa record for every one of
49,750 passport × destination pairs, in 15 languages.
Authentication
Three modes depending on the endpoint:
- API key —
x-api-keyrequest header (or?api_key=query param).
This is what you use for product code.
- Public — no auth at all. Used by
/stats,/score,/score/compare,
/live*, /register, /affiliate/register|track-click|apply-referral.
The /visa/check endpoint is also keyless when the request comes fromvisa.orizn.app, localhost, or a Chrome extension origin (for the
public landing demo and the browser extension).
- Session cookie —
orizn_tokencookie. Dashboard-only endpoints
(key rotation, Stripe checkout/portal). Not callable through a third-party
gateway like RapidAPI.
Quota
Five endpoints count against your monthly quota: /visa, /visa/check,/visa/bulk and /visa/group bill one request per call whatever the
number of pairs they resolve; /visa/decision bills one request per
distinct country resolved, and reports the figure in meta.pairs_charged.
Everything else (stats, score, live, devices, webhooks, team keys, account,
affiliate) is free against quota.
Quotas reset on the 1st of each month, UTC.
Versioning and deprecation
/v1/ is stable and stays reachable.
- Additive changes ship without notice — new fields, new enum members,
new endpoints. Parse defensively and ignore what you do not recognise.
- Breaking changes never land in v1. A removed or renamed field, a
narrowed type, a removed endpoint: those ship as /v2, and /v1 keeps
answering.
- Six months of notice before anything in v1 stops working, counted
from the dated entry in the changelog at
.
- During that window every affected response carries
Deprecationand
Sunset headers (RFC 9745 / RFC 8594) and a Link header to the
migration note, so your monitoring sees it before your users do.
- No silent removals, no shortened windows.
One endpoint is currently withdrawn: /api/v1/visa/changes returns 503.
See its description below.
Data quality
Responses carry source_url and last_verified_at — the official page a
pair was read from and the date it was last read. **Both are null on
pairs that have not been re-sourced yet, and that is most of them**: 56 of
199 passport countries currently have an official source on file. Branch on
the field, never on the count.
A separate requirement_status: "uncertain" field appears on the pairs
whose legal regime is unsettled — a country that has left a bloc whose
freedom-of-movement treaty was the legal basis for entry. It never replacesrequirement, and the key is absent on every unaffected pair.
Conventions
- All country codes are ISO 3166-1 alpha-3 (
FRA,USA,JPN). - All timestamps are ISO 8601 with a UTC suffix.
- Responses are JSON / UTF-8.
- CORS open on every public endpoint, OPTIONS preflight implemented.
/visaand/visa/checkalso supportAccept: text/markdownfor a
human-readable rendering.
SDKs
- JavaScript / TypeScript —
npm install orizn - Python —
pip install orizn - MCP server (Claude, Cursor, Codex) —
npx orizn-visa-mcp
Endpoints 30
Visa data
- GETFull visa record, paid per request over x402 (no account, no API key)
/api/x402/visa?passport=FRA&destination=FRASame record as GET /api/v1/visa on a Pro plan, but paid per call over the x402 protocol instead of an API key: 0.03 USD in USDC on Base. Call it once without… - GETFull visa intelligence
/api/v1/visa?passport=FRA&destination=FRAThe flagship endpoint. Returns the full VisaData object — documents, process, fees, embassies, transit visa, vaccinations, safety advisories, overstay… - GETLightweight yes/no visa check
/api/v1/visa/check?passport=FRA&destination=FRAMinimal payload — just the requirement type, allowed stay, and a one-line description. An _upgrade_preview object reports how much richer data the full /visa… - GETAll destinations for a single passport (Pro+)
/api/v1/visa/bulk?passport=FRASeveral destinations for one passport in a single round-trip. The destination parameter is required: pass a comma-separated list of up to 25 ISO3 codes. Each… - GETGroup trip — multi-passport intersection (Hobby+)
/api/v1/visa/group?passports=USA,FRA,INDPass 2 to 10 passports and get back every destination reachable by all of them, with the per-passport breakdown and the group's worst-case requirement. A… - POSTItinerary decision — answers a trip, not a pair
/api/v1/visa/decisionPost a whole trip — passport, ordered stops with dates, transit stops, passport expiry — and get a per-step decision plus the blockers that only a full… - GETPolicy change feed — WITHDRAWN, returns 503
/api/v1/visa/changesDeprecated. This endpoint is not available and is not part of any plan. It returns 503 with Retry-After: 86400 for every caller. The previous feed compared… - GETCoverage statistics (public)
/api/v1/visa/statsPublic, no auth, edge-cached for one hour.
Passport scoring
- GETPassport mobility score (public)
/api/v1/visa/score?passport=FRAComposite mobility score and global rank for one passport — factoring in visa-free / visa-on-arrival / e-visa access, destination diversity and an economic… - GETCompare two passports (public)
/api/v1/visa/score/compare?passport1=FRA&passport2=FRASide-by-side comparison of two passports — individual scores, set difference of destinations they unlock, and a normalised combined score (max 1000). Powers…
Live activity
- GETLive activity Server-Sent Events stream (public)
/api/v1/visa/liveEach successful /visa or /visa/check call worldwide produces an event with {passport, destination, timestamp}. A : keepalive comment is emitted every 2 s when… - GETRecent activity snapshot (public)
/api/v1/visa/live/recentSame data as /live but as a JSON snapshot. Edge-cached for 5 s.
Push notifications
- POSTRegister a device for push notifications
/api/v1/visa/devicesSubscribe an APNs / FCM device token to receive push notifications when visa policies change. Idempotent on device_token. - DELETEUnsubscribe a device
/api/v1/visa/devices/:id - PATCHUpdate a device subscription
/api/v1/visa/devices/:idAt least one field is required.
Webhooks
- GETList your webhooks (Business+)
/api/v1/visa/webhooks - POSTCreate a webhook (Business+)
/api/v1/visa/webhooksRegister a URL to receive POSTs whenever a policy change matches your filter. Response carries a one-time secret — store it now. Verify with HMAC-SHA256 of… - DELETEDelete a webhook (Business+)
/api/v1/visa/webhooks?id=17
Team keys
- GETList team subkeys (Business+)
/api/v1/visa/team-keys - POSTCreate a team subkey (Business+)
/api/v1/visa/team-keysMint a new team subkey. Prefix orizn_visa_team_. Shares quota with the owner account. - DELETEDeactivate a team subkey (Business+)
/api/v1/visa/team-keys?id=7Soft delete — flips active to false.
Account & billing
- POSTSign up (get a free API key)
/api/v1/visa/registerSelf-serve signup. Returns a free-plan API key (100 req/month). Idempotent on email — re-registering returns the existing key. - GETGet the logged-in user's API key (session-only)
/api/v1/visa/auth/ensure-keyDashboard helper. Session-cookie only — not callable through RapidAPI. - POSTRotate the API key (session-only)
/api/v1/visa/auth/regenerate-key - POSTStart a paid-plan checkout (session-only)
/api/v1/visa/stripe/checkout - POSTOpen the Stripe billing portal (session-only)
/api/v1/visa/stripe/portal
Affiliate program
- POSTBecome an affiliate (public)
/api/v1/visa/affiliate/registerOpen a partner account. Returns an affiliate_id (format aff_<8 hex>) you embed in checkout URLs to earn 15% commission. Idempotent on email. - POSTRecord an affiliate click (public)
/api/v1/visa/affiliate/track-clickIncrement the click counter. Fire-and-forget. - POSTAttach a referral to a user (public)
/api/v1/visa/affiliate/apply-referralBind an existing user to a referrer after sign-up. Sets referred_by; the referrer earns 15% on the user's future subscriptions. - GETAffiliate dashboard data
/api/v1/visa/affiliate/statsLifetime + this-month performance for an affiliate account. Auth: either the orizn_token cookie (dashboard) or affiliate_id + email query params (iOS / API).
API details
- Base URL
https://visa.orizn.app- Authentication
- An API key in the x-api-key header
An API key in the api_key query parameter
An API key in the orizn_token cookie - Operations
- 30 operations on 25 pathsGET 15POST 11DELETE 3PATCH 1
1 marked deprecated - Main resources
- Visa data 8Account & billing 5Affiliate program 4Push notifications 3Team keys 3Webhooks 3Live activity 2Passport scoring 2
- Response formats
application/jsontext/event-stream- Description format
- OpenAPI 3.0.3, API version
1.1.0 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- Orizn's published OpenAPI description
How to test the Orizn Visa API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Orizn Visa API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the x-api-key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Full visa record, paid per request over x402 (no account, no API key)” (GET /api/x402/visa?passport=FRA&destination=FRA), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Orizn Visa API?
> Visa requirements, fees, embassies, transit rules and more > for every passport / destination pair in the world — in 15 languages. The Orizn Visa API… It is listed under Logistics & shipping and has 30 endpoints.
Who publishes the Orizn Visa API?
It is listed from Orizn's public API description (an OpenAPI document), not published by Orizn on Swastik Codes. Anyone who controls visa.orizn.app can claim the profile by adding a DNS TXT record.
What is the base URL of the Orizn Visa API?
Requests go to https://visa.orizn.app. Endpoint paths are added to this base URL.
How do I authenticate with the Orizn Visa API?
It accepts 3 methods: an API key in the x-api-key header; an API key in the api_key query parameter; an API key in the orizn_token cookie.
How many endpoints does the Orizn Visa API have?
30 operations on 25 paths (15 GET, 11 POST, 3 DELETE, 1 PATCH). The largest groups are Visa data, Account & billing, Affiliate program, Push notifications.
Is forking the Orizn Visa API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.