{"openapi":"3.1.0","info":{"title":"Visareq API","version":"0.1.0","description":"A hand-curated, general and point-in-time visa-requirement reference by passport/destination pair for 5 major passports against popular destinations — visa-free, ETA, e-visa, visa-on-arrival and visa-required categories, comparisons, reverse lookup and a document checklist. Not authoritative or real-time; always reverify before travel.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://visareq.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/visareq/docs"},"termsOfService":"https://connectorbay.com/visareq/terms"},"servers":[{"url":"https://visareq.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/visareq/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/visa_requirement":{"post":{"operationId":"visa_requirement","summary":"One passport/destination pair's general visa-requirement category (visa-free, ETA, e-visa, visa on","description":"One passport/destination pair's general visa-requirement category (visa-free, ETA, e-visa, visa on\n    arrival, or visa required), typical maximum stay, and notes. Use for \"do I need a visa for Thailand on a\n    US passport\". GENERAL, POINT-IN-TIME reference only — always reverify with an official source.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"passport":{"description":"Passport / nationality.","examples":["United States","India"],"minLength":1,"title":"Passport","type":"string"},"destination":{"description":"Destination country.","examples":["Thailand","France"],"minLength":1,"title":"Destination","type":"string"}},"required":["passport","destination"],"title":"visa_requirementArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_destinations":{"post":{"operationId":"compare_destinations","summary":"Lines up several destinations' visa requirement for one passport side by side. Use for \"compare visa","description":"Lines up several destinations' visa requirement for one passport side by side. Use for \"compare visa\n    requirements for Thailand, Vietnam and Indonesia on an Indian passport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"passport":{"description":"Passport / nationality.","minLength":1,"title":"Passport","type":"string"},"destinations":{"description":"2-15 destination countries to compare.","items":{"type":"string"},"maxItems":15,"minItems":2,"title":"Destinations","type":"array"}},"required":["passport","destinations"],"title":"compare_destinationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/destinations_by_category":{"post":{"operationId":"destinations_by_category","summary":"Every covered destination in one requirement category for a passport. Use for \"which countries can a UK","description":"Every covered destination in one requirement category for a passport. Use for \"which countries can a UK\n    passport enter completely visa-free\" (from this reference's covered destination list, not exhaustively).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"passport":{"description":"Passport / nationality.","minLength":1,"title":"Passport","type":"string"},"category":{"description":"'visa_free', 'eta', 'e_visa', 'visa_on_arrival', or 'visa_required'.","examples":["visa_free"],"title":"Category","type":"string"}},"required":["passport","category"],"title":"destinations_by_categoryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/no_visa_needed_destinations":{"post":{"operationId":"no_visa_needed_destinations","summary":"Covered destinations needing nothing arranged in advance beyond a light Electronic Travel Authorization —","description":"Covered destinations needing nothing arranged in advance beyond a light Electronic Travel Authorization —\n    i.e. visa-free or ETA — for a passport, visa-free listed first. Use for \"where can I travel on short notice\n    with an Australian passport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"passport":{"description":"Passport / nationality.","minLength":1,"title":"Passport","type":"string"}},"required":["passport"],"title":"no_visa_needed_destinationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/reverse_lookup_by_destination":{"post":{"operationId":"reverse_lookup_by_destination","summary":"For one destination, the requirement for every passport this reference covers, side by side. Use for","description":"For one destination, the requirement for every passport this reference covers, side by side. Use for\n    \"how does Thailand's visa policy differ for US vs Indian vs South African passports\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"destination":{"description":"Destination country.","examples":["Thailand"],"minLength":1,"title":"Destination","type":"string"}},"required":["destination"],"title":"reverse_lookup_by_destinationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/passports_covered":{"post":{"operationId":"passports_covered","summary":"The passports this reference has data for (5 total) — this is a curated reference, not a database of","description":"The passports this reference has data for (5 total) — this is a curated reference, not a database of\n    every country's passport.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"passports_coveredArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/destinations_covered":{"post":{"operationId":"destinations_covered","summary":"The destinations covered for one passport. Use to check whether a specific destination is in this","description":"The destinations covered for one passport. Use to check whether a specific destination is in this\n    reference before calling visa_requirement.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"passport":{"description":"Passport / nationality.","minLength":1,"title":"Passport","type":"string"}},"required":["passport"],"title":"destinations_coveredArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/visa_category_glossary":{"post":{"operationId":"visa_category_glossary","summary":"Defines the five requirement categories used throughout this reference: visa-free, ETA, e-visa, visa on","description":"Defines the five requirement categories used throughout this reference: visa-free, ETA, e-visa, visa on\n    arrival, and visa required.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"visa_category_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/travel_document_checklist":{"post":{"operationId":"travel_document_checklist","summary":"General, non-country-specific reminders that apply regardless of visa category — passport validity,","description":"General, non-country-specific reminders that apply regardless of visa category — passport validity,\n    blank-page requirements, onward-ticket proof, transit rules, minors' documents, and named exceptions. Use\n    for \"what else should I check before an international trip besides the visa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"travel_document_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}