{"openapi":"3.1.0","info":{"title":"Border Check API","version":"0.1.0","description":"A fully local, hand-curated reference for common international border-crossing document requirements: passport validity norms, proof of onward travel, customs and currency declaration basics, and a land-border checklist. General/educational, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://bordercheck.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/bordercheck/docs"},"termsOfService":"https://connectorbay.com/bordercheck/terms"},"servers":[{"url":"https://bordercheck.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/bordercheck/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/document_checklist":{"post":{"operationId":"document_checklist","summary":"A general checklist of documents commonly needed to cross an international border, for a trip purpose","description":"A general checklist of documents commonly needed to cross an international border, for a trip purpose\n    (tourism, business, transit) and mode (air, land, sea). Use for \"what documents do I need for an international\n    trip\", \"what do I need for a business trip abroad\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"purpose":{"default":"tourism","description":"Trip purpose.","examples":["tourism","business","transit"],"title":"Purpose","type":"string"},"mode":{"default":"air","description":"How you're crossing.","examples":["air","land","sea"],"title":"Mode","type":"string"}},"title":"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}},"/v1/tools/passport_validity_rule":{"post":{"operationId":"passport_validity_rule","summary":"Explains the widely-applied \"6 months beyond your stay\" passport-validity rule: what it means, why it","description":"Explains the widely-applied \"6 months beyond your stay\" passport-validity rule: what it means, why it\n    exists, how it differs from the shorter 3-month norm many destinations use, and the separate blank-pages\n    requirement. Use for \"does my passport need 6 months left on it\", \"why do some countries need extra passport\n    validity\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"passport_validity_ruleArguments","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/region_validity_lookup":{"post":{"operationId":"region_validity_lookup","summary":"Checks a country/region name against Border Check's curated illustrative examples of the 6-month vs 3-month","description":"Checks a country/region name against Border Check's curated illustrative examples of the 6-month vs 3-month\n    passport-validity norm. Returns 'unlisted' rather than guessing when the place isn't one of the examples. Use\n    for \"does Egypt need 6 months on my passport\", \"what's France's passport validity rule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"place":{"description":"A country or region name.","examples":["Egypt","France","Vietnam"],"minLength":1,"title":"Place","type":"string"}},"required":["place"],"title":"region_validity_lookupArguments","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/proof_of_onward_travel":{"post":{"operationId":"proof_of_onward_travel","summary":"What counts as proof of onward travel, when it's commonly required, and the risk of not having it. Use for","description":"What counts as proof of onward travel, when it's commonly required, and the risk of not having it. Use for\n    \"what counts as proof of onward travel\", \"I only have a one-way ticket, what do I need\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"proof_of_onward_travelArguments","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/customs_declaration_basics":{"post":{"operationId":"customs_declaration_basics","summary":"General customs-declaration categories (duty-free allowance, restricted goods, food/plant/animal products,","description":"General customs-declaration categories (duty-free allowance, restricted goods, food/plant/animal products,\n    medications) and the practical \"when in doubt, declare it\" guidance. Use for \"what do I need to declare at\n    customs\", \"what's a duty-free allowance\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"customs_declaration_basicsArguments","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/currency_declaration_norm":{"post":{"operationId":"currency_declaration_norm","summary":"The common ~US $10,000-equivalent cash/monetary-instrument declaration threshold, verified for the US,","description":"The common ~US $10,000-equivalent cash/monetary-instrument declaration threshold, verified for the US,\n    Canada and the EU, with the caveat that it varies by country. Use for \"how much cash can I bring across a\n    border without declaring it\", \"do I need to declare $8,000 in cash\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"currency_declaration_normArguments","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/land_border_checklist":{"post":{"operationId":"land_border_checklist","summary":"Checklist items specific to land border crossings beyond the standard air-travel basics: vehicle documents,","description":"Checklist items specific to land border crossings beyond the standard air-travel basics: vehicle documents,\n    temporary import permits, insurance, and practical notes on wait times and unsolicited 'helpers'. Use for \"what\n    extra documents do I need driving across a border\", \"crossing a land border by car\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"land_border_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}},"/v1/tools/document_glossary":{"post":{"operationId":"document_glossary","summary":"Definitions of common border/travel-document terms — visa, eTA, transit visa, proof of onward travel, duty-","description":"Definitions of common border/travel-document terms — visa, eTA, transit visa, proof of onward travel, duty-\n    free allowance, port of entry, and more. Use for \"what's an eTA\", \"what's the difference between a visa and a\n    transit visa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"document_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/pretrip_summary":{"post":{"operationId":"pretrip_summary","summary":"Combines the document checklist, passport-validity rule, proof-of-onward-travel, customs and currency-","description":"Combines the document checklist, passport-validity rule, proof-of-onward-travel, customs and currency-\n    declaration basics (and, for a land crossing, the land-border checklist) into one pre-trip summary. Use for \"give\n    me a full checklist before I cross into Kenya by land\", \"what do I need to know before an international trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"purpose":{"default":"tourism","description":"Trip purpose.","examples":["tourism","business","transit"],"title":"Purpose","type":"string"},"mode":{"default":"air","description":"How you're crossing.","examples":["air","land","sea"],"title":"Mode","type":"string"},"region_or_country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A country/region to also check against the passport-validity examples.","title":"Region Or Country"}},"title":"pretrip_summaryArguments","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/disclaimer":{"post":{"operationId":"disclaimer","summary":"The full disclaimer: Border Check is general, educational information, not legal advice, and not a","description":"The full disclaimer: Border Check is general, educational information, not legal advice, and not a\n    substitute for the destination's own current official entry requirements. Use for \"is this legal advice\",\n    \"how current is this information\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"disclaimerArguments","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}}}}