{"openapi":"3.1.0","info":{"title":"Idpguide API","version":"0.1.0","description":"A hand-curated, general reference on International Driving Permit expectations in 40 countries — required, recommended, not typically needed, or not recognized at all — with comparison, category browsing, a special-permit-countries list, a Geneva/Vienna convention explainer, general IDP facts and a pre-drive checklist. General information, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://idpguide.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/idpguide/docs"},"termsOfService":"https://connectorbay.com/idpguide/terms"},"servers":[{"url":"https://idpguide.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/idpguide/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/idp_requirement":{"post":{"operationId":"idp_requirement","summary":"One country's general IDP category (commonly required, commonly recommended, not typically needed, or","description":"One country's general IDP category (commonly required, commonly recommended, not typically needed, or\n    not recognized/needs a special permit) plus notes. Use for \"do I need an international driving permit for\n    Japan\". GENERAL INFORMATION, NOT LEGAL ADVICE — verify with an official source.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country name.","examples":["Japan","United States"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"idp_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_countries":{"post":{"operationId":"compare_countries","summary":"Lines up several countries' IDP expectations side by side. Use for \"compare IDP rules for the US, UK and","description":"Lines up several countries' IDP expectations side by side. Use for \"compare IDP rules for the US, UK and\n    Australia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"countries":{"description":"2-15 country names to compare.","items":{"type":"string"},"maxItems":15,"minItems":2,"title":"Countries","type":"array"}},"required":["countries"],"title":"compare_countriesArguments","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/countries_by_category":{"post":{"operationId":"countries_by_category","summary":"Every covered country in one IDP-expectation category.","description":"Every covered country in one IDP-expectation category.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"'commonly_required', 'commonly_recommended', 'not_typically_needed', or 'not_recognized_special_permit'.","examples":["commonly_required"],"title":"Category","type":"string"}},"required":["category"],"title":"countries_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/countries_list":{"post":{"operationId":"countries_list","summary":"Every country this reference has IDP data for (40 total, a curated sample, not exhaustive).","description":"Every country this reference has IDP data for (40 total, a curated sample, not exhaustive).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"countries_listArguments","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/category_glossary":{"post":{"operationId":"category_glossary","summary":"Defines the four IDP-expectation categories used throughout this reference.","description":"Defines the four IDP-expectation categories used throughout this reference.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"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/special_permit_countries":{"post":{"operationId":"special_permit_countries","summary":"Countries that don't accept the standard International Driving Permit at all and require a different","description":"Countries that don't accept the standard International Driving Permit at all and require a different\n    local or regional document instead (e.g. China's temporary local permit, or the Inter-American Driving\n    Permit used by Brazil, Uruguay and Trinidad and Tobago). Use for \"which countries don't recognize the\n    IDP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"special_permit_countriesArguments","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/convention_info":{"post":{"operationId":"convention_info","summary":"Explains the 1949 Geneva Road Traffic Convention vs the 1968 Vienna Convention on Road Traffic — the two","description":"Explains the 1949 Geneva Road Traffic Convention vs the 1968 Vienna Convention on Road Traffic — the two\n    treaty families behind IDP formats, and why a country recognizing one may not fully recognize the other.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"convention_infoArguments","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/general_idp_facts":{"post":{"operationId":"general_idp_facts","summary":"Facts about International Driving Permits that hold true regardless of destination: it's not a","description":"Facts about International Driving Permits that hold true regardless of destination: it's not a\n    stand-alone license, doesn't grant privileges you lack at home, expires with your home license, and must be\n    obtained before you leave your own country.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"general_idp_factsArguments","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/pre_drive_checklist":{"post":{"operationId":"pre_drive_checklist","summary":"A practical, non-country-specific checklist to run through before driving abroad, beyond just the IDP","description":"A practical, non-country-specific checklist to run through before driving abroad, beyond just the IDP\n    question.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pre_drive_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}}}}