{"openapi":"3.0.3","info":{"title":"Caelara Labs Global Locale Suite","description":"Zero-scrape global locale intelligence for agents and commerce tools: timezone conversion, business-hours math, public holidays, live FX rates, VAT/GST rates, postal-code validation, country ISO enrichment, great-circle distance, plus composite scheduling and cross-border checkout endpoints.","version":"1.0.0","contact":{"email":"ops@caelaralabs.com","url":"https://caelaralabs.com"}},"servers":[{"url":"https://geo.caelaralabs.com"}],"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Proxy-Secret"},"CaelaraKey":{"type":"apiKey","in":"header","name":"X-Caelara-Key"},"x402USDC":{"type":"http","scheme":"bearer","description":"x402 USDC payment on Base network"}}},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/global-scheduling-composite":{"get":{"summary":"Find meeting slots that fall inside working hours for every participant timezone, skipping weekends and public holidays, with per-participant local times","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"timezones","in":"query","required":true,"description":"Comma list of IANA timezones; the first is the organizer whose local day anchors the search","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"Organizer-local date YYYY-MM-DD (default today)","schema":{"type":"string"}},{"name":"duration_minutes","in":"query","required":false,"description":"Meeting length in minutes (default 60)","schema":{"type":"integer"}},{"name":"work_start","in":"query","required":false,"description":"Working day start HH:MM (default 09:00)","schema":{"type":"string"}},{"name":"work_end","in":"query","required":false,"description":"Working day end HH:MM (default 17:00)","schema":{"type":"string"}},{"name":"countries","in":"query","required":false,"description":"Comma list of ISO alpha-2 codes aligned with timezones, used to skip public holidays","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/cross-border-checkout-composite":{"get":{"summary":"Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"amount","in":"query","required":true,"description":"Order subtotal in the source currency","schema":{"type":"number"}},{"name":"currency","in":"query","required":true,"description":"Source currency ISO 4217 code, e.g. USD","schema":{"type":"string"}},{"name":"country","in":"query","required":true,"description":"Destination country (ISO alpha-2, e.g. DE)","schema":{"type":"string"}},{"name":"postal_code","in":"query","required":false,"description":"Destination postal code to validate","schema":{"type":"string"}},{"name":"prices_include_tax","in":"query","required":false,"description":"true when the amount already includes tax","schema":{"type":"string"}},{"name":"vat_id","in":"query","required":false,"description":"Buyer VAT ID for B2B reverse-charge screening (format only, not VIES-verified)","schema":{"type":"string"}},{"name":"origin_country","in":"query","required":false,"description":"Seller country (ISO alpha-2) for reverse-charge screening","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/timezone-converter":{"get":{"summary":"Convert a date-time between IANA timezones with offsets, abbreviations and DST flags","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"from","in":"query","required":true,"description":"Source IANA timezone, e.g. America/New_York","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Comma list of target IANA timezones","schema":{"type":"string"}},{"name":"time","in":"query","required":false,"description":"ISO 8601 time; wall time is read in the source timezone (default now)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/business-hours-calc":{"get":{"summary":"Is a location open right now (or at a given instant) and when does it next open or close","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"tz","in":"query","required":true,"description":"IANA timezone of the business","schema":{"type":"string"}},{"name":"start","in":"query","required":false,"description":"Opening time HH:MM (default 09:00)","schema":{"type":"string"}},{"name":"end","in":"query","required":false,"description":"Closing time HH:MM (default 17:00)","schema":{"type":"string"}},{"name":"days","in":"query","required":false,"description":"Comma list of open weekdays, 0=Sunday..6=Saturday (default 1,2,3,4,5)","schema":{"type":"string"}},{"name":"at","in":"query","required":false,"description":"ISO 8601 instant to evaluate (default now)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/public-holiday-lookup":{"get":{"summary":"Public holidays for a country and year, with an optional is-holiday check for one date","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO alpha-2 country code","schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Year (default current)","schema":{"type":"integer"}},{"name":"date","in":"query","required":false,"description":"Optional YYYY-MM-DD to test","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/live-fx-rates":{"get":{"summary":"Live foreign-exchange rates for a base currency with optional amount conversion","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"base","in":"query","required":false,"description":"Base currency ISO 4217 (default USD)","schema":{"type":"string"}},{"name":"symbols","in":"query","required":false,"description":"Comma list of target currencies (default major set)","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Amount of the base currency to convert","schema":{"type":"number"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/vat-gst-rate-lookup":{"get":{"summary":"Standard and reduced VAT/GST rates for a country with optional tax amount calculation","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO alpha-2 country code","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Net amount to compute tax on","schema":{"type":"number"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/postal-code-validator":{"get":{"summary":"Validate and normalize a postal code for a country","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO alpha-2 country code","schema":{"type":"string"}},{"name":"code","in":"query","required":true,"description":"Postal code to validate","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/country-iso-enricher":{"get":{"summary":"Resolve a country name or ISO code to alpha-2/alpha-3/numeric codes, currency, calling code, region, capital and primary timezone","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Country name, alpha-2, alpha-3 or numeric code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/distance-haversine-calc":{"get":{"summary":"Great-circle distance, initial bearing and midpoint between two coordinates","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"lat1","in":"query","required":true,"description":"Latitude of point A","schema":{"type":"number"}},{"name":"lon1","in":"query","required":true,"description":"Longitude of point A","schema":{"type":"number"}},{"name":"lat2","in":"query","required":true,"description":"Latitude of point B","schema":{"type":"number"}},{"name":"lon2","in":"query","required":true,"description":"Longitude of point B","schema":{"type":"number"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}}}}