canonical: https://jentic.com/apis/orizn.app/orizn # Orizn App Orizn Visa API The Orizn Visa API returns visa requirements, fees, embassy details, transit rules, and more for passport and destination pairs, with up to 30 data points per pair in 15 languages. It answers single-pair lookups and lightweight yes/no checks, bulk lookups for a whole passport, multi-passport group trips, and itinerary decisions, and it computes passport mobility scores and comparisons. Device, webhook, and team-key operations manage subscriptions and access for higher tiers. ## For AI agents Look up visa requirements, fees, and transit rules for passport and destination pairs, run yes/no checks and bulk lookups, and compute passport mobility scores. ## Scope Does not handle flight booking, hotel reservations, or passport applications. Use for visa requirement data and passport scoring only. ## Capabilities - Look up full visa requirements for a passport and destination pair - Run a lightweight yes/no visa check for a pair - Fetch all destinations for a single passport in bulk - Resolve a multi-passport group trip to a shared outcome - Compute a passport mobility score and compare two passports - Make an itinerary decision across a whole trip rather than one pair ## Use cases ### AI Agent Visa Check An AI agent connected through Jentic answers travel questions by checking whether a given passport needs a visa for a destination and returning the requirement with fees and transit rules. The lightweight check gives a fast yes/no, while the full lookup returns the complete set of data points for a confident answer. Example prompt: Check whether a US passport needs a visa for Japan and return the requirement and fees ### Trip Planning Across Destinations A travel planner's agent fetches all destinations a passport can enter in a single bulk call and sorts them by whether a visa is required. This supports 'where can I go visa-free' style planning without one call per country. Example prompt: Fetch all destinations a given passport can enter and group them by requirement ### Passport Mobility Comparison To compare travel freedom, an agent computes mobility scores for two passports and returns the comparison. The score and compare operations summarize how many destinations each passport reaches, which is useful for relocation or dual-citizenship decisions. Example prompt: Compute mobility scores for two passports and compare them ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/visa` | Full visa intelligence for a pair | | GET | `/api/v1/visa/check` | Lightweight yes/no visa check | | GET | `/api/v1/visa/bulk` | All destinations for a passport | | GET | `/api/v1/visa/group` | Multi-passport group trip | | GET | `/api/v1/visa/score` | Passport mobility score | | GET | `/api/v1/visa/score/compare` | Compare two passports | | POST | `/api/v1/visa/decision` | Itinerary decision for a trip | ## Key resources - **Visa Data** — Look up visa requirements, checks, bulk, group, and decisions - **Passport Scoring** — Compute and compare passport mobility scores - **Webhooks** — Create and manage webhooks for policy changes - **Team Keys** — Create and deactivate team subkeys - **Devices** — Register and manage devices for push notifications ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 62 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 85 / 100 - Developer Experience & Jentic Compatibility: 71 / 100 - AI-Readiness & Agent Experience: 46 / 100 - Agent Usability: 94 / 100 - Security: 38 / 100 - AI Discoverability: 73 / 100 - **View full report:** https://jentic.com/apis/orizn.app/orizn/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Orizn Visa API by hand means managing its API key in the `x-api-key` header or `api_key` query parameter, separating public endpoints from key-gated ones, and shaping each passport and destination query yourself. Through Jentic you install once, import Orizn from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The Orizn Visa API carries the passport and destination in query parameters, so rules bound which operations your agent may call, not which countries it queries. You choose the operations it may use, such as visa lookups and checks, so creating webhooks or managing team keys is not included unless you add them. - **Credential handling:** Your Orizn API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'check visa requirements' or 'compare two passports', and Jentic returns the matching Orizn operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Amadeus** — Amadeus offers broad travel data including some entry-requirement content. - **Duffel** — Duffel books flights once a trip's visa requirements are confirmed. - **AviationStack** — AviationStack adds live flight and route data to a travel plan. ## FAQ ### What authentication does the Orizn Visa API use? The data endpoints authenticate with an API key, passed in the `x-api-key` header or as an `api_key` query parameter, as declared in its OpenAPI spec. Many endpoints such as stats, scores, and live activity are public and need no key, and dashboard-only operations use the `orizn_token` session cookie. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time. ### Can I check whether a passport needs a visa with the Orizn Visa API? Yes. The check operation returns a lightweight yes/no result for a passport and destination, while the full visa operation returns the complete set of data points including fees, embassy details, and transit rules. ### What are the rate limits for the Orizn Visa API? The OpenAPI spec does not publish fixed rate limits; several endpoints count against your monthly plan allowance. See the Orizn documentation at https://visa.orizn.app for the limits that apply to your plan. ### Can I limit what my agent is allowed to do with the Orizn Visa API? Yes. Write a rule that allows only the visa-lookup and check operations, so the agent can read visa requirements but cannot create webhooks, manage team keys, or rotate your API key, and every call it makes is logged. ### How do I check visa requirements with the Orizn Visa API through Jentic? Search Jentic for 'check visa requirements', add the Orizn Visa API from the directory, and store your API key once. Your agent then runs a check or a full lookup for a passport and destination. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Is there an Orizn Visa API MCP server? You don't need an MCP server to give your agent the Orizn Visa API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the visa, check, bulk, and score operations. That keeps extra tool definitions out of the agent's context.