{"uid":"cap_brGxXVuPzw7XBDaytGez6","slug":"2s-visa-requirement-lookup-692c9bba","name":"2s Visa Requirement Lookup","description":"Look up the visa requirement for a traveler with a given passport visiting a destination country. Pass passport and destination as ISO-3166 alpha-3, alpha-2, or country name (e.g. passport=USA destination=Japan). Returns the requirement category — 'visa free' (with visaFreeDays, the allowed days), 'visa on arrival', 'e-visa', 'eta' (electronic travel authorization), 'visa required' (must arrange in advance), or 'no admission' — plus a plain-language description and the resolved passport/destination names. Data from the community-maintained Passport Index dataset (MIT). Informational only — not official immigration advice; verify with the destination's embassy before travel.","url":"https://2s.io/api/travel/visa","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["passport","destination"],"properties":{"passport":{"type":"string","description":"Passport country (ISO alpha-3/alpha-2 or name)."},"destination":{"type":"string","description":"Destination country (ISO alpha-3/alpha-2 or name)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"passport":"US","destination":"JP"}}},"response":{"data":{"ok":true,"items":[{"note":"Informational only — verify with the destination embassy/consulate before travel. Requirements change frequently and depend on purpose, duration, and individual circumstances.","source":{"url":"https://github.com/ilyankou/passport-index-dataset","license":"MIT. Community-maintained; informational, not official immigration advice.","provider":"Passport Index dataset (ilyankou/passport-index-dataset)"},"category":"visa free","passport":{"code":"USA","name":"United States"},"description":"Visa-free entry for up to 90 days.","destination":{"code":"JPN","name":"Japan"},"requirement":"visa free","visaFreeDays":90}],"total":1,"source":{"url":"https://github.com/ilyankou/passport-index-dataset","license":"MIT. Community-maintained; informational, not official immigration advice.","provider":"Passport Index dataset (ilyankou/passport-index-dataset)"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"travel.visa","settlement":{"txHash":"0x22731a910237e34342b4f335849f5c6a4190510430fa4d33b41d2e38b233cc5b","network":"eip155:8453","success":true}}}},"exampleRequest":{"passport":"US","destination":"JP"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1jPfExItiqqMgwVd_8V3d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns visa entry requirements (visa-free, on-arrival, e-visa, required, etc.) for a given passport/destination country pair","exampleAgentPrompt":"Can you check whether a US passport holder needs a visa to visit Japan, and if it's visa-free, how many days are allowed?","exampleUseCases":null,"resultDescription":"Returns an array of visa requirement entries each containing: visa category (e.g. 'visa free', 'visa on arrival', 'visa required'), number of visa-free days if applicable, a human-readable description of the entry requirement, normalized passport and destination country codes and names, and an optional note reminding users to verify with the destination embassy. Also includes the data source attribution (Passport Index dataset, MIT license).","failureModes":["Invalid or unrecognized country code/name returns an error or empty result set","Missing required 'passport' or 'destination' query parameters returns a 400-level error","Data may be outdated — visa policies change frequently and the community-maintained dataset may lag behind official policy changes","Payment failure via x402 protocol results in a 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when an AI agent needs to quickly determine visa entry requirements between any two countries without requiring API key registration. Ideal for travel planning workflows, itinerary assistants, or compliance checks. Prefer this over official government sources when low-latency machine-readable responses are needed; note that results are informational only and sourced from the community-maintained Passport Index dataset, so always recommend users verify with official embassy sources for high-stakes travel decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:07:02.899Z","isFirstParty":false}