{"openapi":"3.1.0","info":{"title":"Pet Travel Prep API","version":"0.1.0","description":"A fully local pet-travel requirement reference and planning calculator: a universal framework plus three worked, web-verified examples (UK-to-EU, Hawaii, Australia), with real compute for timeline planning, microchip/vaccination ordering, and a tapeworm-treatment window. General framework, not a per-country lookup.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://pettravel.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/pettravel/docs"},"termsOfService":"https://connectorbay.com/pettravel/terms"},"servers":[{"url":"https://pettravel.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/pettravel/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/general_framework":{"post":{"operationId":"general_framework","summary":"The universal pet-travel framework: microchip, rabies vaccination timing, rabies titer test, official","description":"The universal pet-travel framework: microchip, rabies vaccination timing, rabies titer test, official\n    health certificate, breed/species rules, quarantine vs direct release, import permits, and planning advice.\n    Use for \"what do I generally need to fly with my pet internationally\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"general_frameworkArguments","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/list_examples":{"post":{"operationId":"list_examples","summary":"Lists the three worked, individually web-verified pet-travel examples available (UK-to-EU, Hawaii,","description":"Lists the three worked, individually web-verified pet-travel examples available (UK-to-EU, Hawaii,\n    Australia). Use for \"what example routes do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_examplesArguments","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/example_lookup":{"post":{"operationId":"example_lookup","summary":"Full detail for one worked, web-verified pet-travel example. Use for \"what does my dog need to enter the","description":"Full detail for one worked, web-verified pet-travel example. Use for \"what does my dog need to enter the\n    EU from the UK\", \"what's Hawaii's 5-day program\", \"what does Australia require\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"example":{"description":"uk_to_eu | hawaii_usa | australia","examples":["uk_to_eu","hawaii_usa","australia"],"title":"Example","type":"string"}},"required":["example"],"title":"example_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/compare_examples":{"post":{"operationId":"compare_examples","summary":"Side-by-side comparison of the three worked examples by requirement count and minimum lead time. Use for","description":"Side-by-side comparison of the three worked examples by requirement count and minimum lead time. Use for\n    \"which of your example destinations takes the longest to prepare for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"compare_examplesArguments","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/timeline_planner":{"post":{"operationId":"timeline_planner","summary":"Checks whether a stated number of days until travel clears one example's single longest minimum-wait","description":"Checks whether a stated number of days until travel clears one example's single longest minimum-wait\n    requirement (e.g. Australia's 180-day approved-country residency). Use for \"I'm traveling to Australia in 90\n    days, is that enough time\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"example":{"description":"uk_to_eu | hawaii_usa | australia","title":"Example","type":"string"},"days_until_travel":{"description":"How many days from today until the intended travel date.","minimum":0,"title":"Days Until Travel","type":"number"}},"required":["example","days_until_travel"],"title":"timeline_plannerArguments","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/microchip_vaccination_order_check":{"post":{"operationId":"microchip_vaccination_order_check","summary":"Checks the universal microchip-before-vaccination ordering rule that most pet-travel schemes require. Use","description":"Checks the universal microchip-before-vaccination ordering rule that most pet-travel schemes require. Use\n    for \"my vet vaccinated my dog and chipped her the next day, is that okay\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"microchip_days_before_vaccination":{"description":"Days the microchip was implanted BEFORE the rabies vaccination; negative if the vaccination came first.","title":"Microchip Days Before Vaccination","type":"number"}},"required":["microchip_days_before_vaccination"],"title":"microchip_vaccination_order_checkArguments","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/tapeworm_treatment_window_check":{"post":{"operationId":"tapeworm_treatment_window_check","summary":"Applies the UK/EU rule for dogs entering Finland, Ireland, Malta or Norway: tapeworm treatment must be","description":"Applies the UK/EU rule for dogs entering Finland, Ireland, Malta or Norway: tapeworm treatment must be\n    recorded between 24 hours and 5 days before entry. Use for \"is a tapeworm treatment done 3 days before arrival\n    in Ireland valid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hours_before_entry":{"description":"Hours before entry the tapeworm treatment was recorded.","minimum":0,"title":"Hours Before Entry","type":"number"}},"required":["hours_before_entry"],"title":"tapeworm_treatment_window_checkArguments","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/quarantine_risk_estimate":{"post":{"operationId":"quarantine_risk_estimate","summary":"A general risk read on direct-release vs quarantine likelihood, based on which universal requirements are","description":"A general risk read on direct-release vs quarantine likelihood, based on which universal requirements are\n    met -- not a determination by any specific destination. Use for \"am I likely to face quarantine if my titer\n    test result is still pending\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"has_microchip":{"description":"Whether the pet has an ISO-compliant microchip.","title":"Has Microchip","type":"boolean"},"has_current_rabies_vaccination":{"description":"Whether the rabies vaccination is current and properly timed.","title":"Has Current Rabies Vaccination","type":"boolean"},"has_required_titer_test":{"default":true,"description":"Whether a required rabies titer test (if the destination needs one) has passed.","title":"Has Required Titer Test","type":"boolean"},"has_certificate_in_window":{"default":true,"description":"Whether the official health certificate was issued within its valid window.","title":"Has Certificate In Window","type":"boolean"},"meets_prior_residency_requirement":{"default":true,"description":"Whether any required prior-residency period in an approved country is met.","title":"Meets Prior Residency Requirement","type":"boolean"}},"required":["has_microchip","has_current_rabies_vaccination"],"title":"quarantine_risk_estimateArguments","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/breed_species_flags":{"post":{"operationId":"breed_species_flags","summary":"Flags general species considerations (ferret/exotic legality and acceptance) and breed considerations","description":"Flags general species considerations (ferret/exotic legality and acceptance) and breed considerations\n    (brachycephalic/flat-faced airline cargo restrictions). Use for \"will my French bulldog have trouble flying\n    cargo\", \"can I bring my pet ferret abroad\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"dog | cat | ferret | other","title":"Species","type":"string"},"breed":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The specific breed, if known.","title":"Breed"}},"required":["species"],"title":"breed_species_flagsArguments","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/pettravel_glossary":{"post":{"operationId":"pettravel_glossary","summary":"Definitions of pet-travel terms -- ISO microchip, rabies titer test (FAVN/RNATT), Animal Health Certificate,","description":"Definitions of pet-travel terms -- ISO microchip, rabies titer test (FAVN/RNATT), Animal Health Certificate,\n    direct release, import permit, brachycephalic breed restriction. Use for \"what's a FAVN test\".","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":"pettravel_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}}}}