Orizn Visa API
Integrations
One tutorial per client, each written by actually running it: the prerequisites, the install, a first call you can copy whole, the real response it returned, what happens on every error, and one end-to-end use case. Every output block on these pages is real stdout, not an illustrative example.
Coverage, from the public /api/v1/visa/stats endpoint you can call yourself without a key: 199 passports, 202 destinations, 40,027 visa records, 15 languages. Country codes are ISO 3166-1 alpha-3 (FRA, JPN, USA), not alpha-2.
Tutorials
Not sure which one? If you are wiring up an AI assistant, start with the MCP server. If you are writing code, take the SDK for your language. If you want to understand what everything else is doing underneath, read the REST page first — it is the shortest.
MCP server
Give your AI assistant real visa data over the Model Context Protocol. Five tools, one npx command, no build step.
Read the tutorial →REST API
The layer everything else sits on. Four endpoints, one header, no SDK required.
Read the tutorial →orizn (npm)
The official npm client. Typed responses, and every failure is a typed error carrying the URL that fixes it.
Read the tutorial →orizn (PyPI)
The official PyPI client. Validates country and language codes before the request leaves your machine, so a typo never costs you quota.
Read the tutorial →orizn (crates.io)
The official crate. Async on tokio, typed errors, one dependency to add.
Read the tutorial →@orizn/langchain
Two ready-made tools for a LangChain.js agent. Drop them in and the model stops inventing entry rules.
Read the tutorial →@orizn/react
A drop-in <VisaChecker /> widget, or the SDK underneath it if you want to build your own UI.
Read the tutorial →Next.js
Keep the key on the server. One route handler, and the browser only ever talks to your own domain.
Read the tutorial →Built with Orizn
Shipped products, publicly installable, running on the same endpoints you get a key for. They are the regression test for the dataset: when a rule changes, it changes here too.
Orizn Visa Checker
Reads the destination off the page you are browsing and shows the visa requirement for your passport as a badge. It calls the same /api/v1/visa endpoints documented here.
Chrome Web Store →Orizn
The travel app: trips, destinations and entry rules. Its visa answers are this API's answers, which is why the two never disagree.
App Store →Orizn Visa — Score Passeport
Passport-first: mobility score, world rank, and where a passport goes without a visa. Built on /api/v1/visa/score and /api/v1/visa/check.
App Store →Also available
These work, and the snippets come straight from their source — but they were not run end to end while writing this page, so they get a short card rather than a tutorial claiming to be verified. Want one written up properly? Say so at [email protected].
WordPress plugin
Orizn Travel Widgets: visa checker, budget calculator, passport score, country comparison and travel checklist, as a Gutenberg block or a shortcode. Install the zip from Plugins → Add New → Upload Plugin.
[orizn_widget type="visa" destination="VNM"]
[orizn_widget type="compare" country1="VNM" country2="THA"]Shortcode taken verbatim from the plugin source. Not exercised in a WordPress install for this page.
Discord & Telegram bots
Reference bots answering !visa FRA JPN / /visa FRA JPN and a passport-score command. Node 20.6+ for Discord; the Telegram bot ships a Dockerfile pinned to Python 3.12.
!visa FRA JPN → FRA → JPN — Visa Free — up to 90 days
/score FRA → FRA Passport Score — 738/1000 — rank #4 / 199The API call these bots make was verified; the bots themselves were not run, as that needs Discord and Telegram tokens.
Custom GPT
A published GPT wired to the API through OpenAPI Actions, with a custom x-api-key header. Its instructions map country names to alpha-3 codes and pick lang from the language the user writes in.
Auth: custom header — x-api-key: orizn_visa_...
Server: https://visa.orizn.appThe GPT is live; its OpenAPI schema was read but not re-imported for this page.
Start with a free key
50 requests a month, no credit card, all 15 languages included. Building something that is not in the list above? Tell us what you need at [email protected].