{"openapi":"3.1.0","info":{"title":"Country Facts","version":"1.0.0","description":"Borders, driving side, time zones, land routes and comparisons for 250 countries and territories. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Country Facts: Borders, driving side, time zones, land routes and comparisons for 250 countries and territories. Use /country-profile for a fact sheet by code or name, /borders for land neighbours, /border-path for the fewest land border crossings between two countries, /driving-side for left or right traffic and neighbours that switch, /timezones for IANA zones with current offsets, /time-difference between two countries or zones, /country-compare for two countries side by side, and /countries-filter to list countries by region, currency, language, driving side or landlocked status. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://country-facts.x402tookit.com"}],"paths":{"/border-path":{"get":{"operationId":"border_path","summary":"Fewest land border crossings between two countries, with the countries passed through, or NO_LAND_ROUTE.","description":"Fewest land border crossings between two countries, with the countries passed through, or NO_LAND_ROUTE.","tags":["countries","borders","route"],"parameters":[{"name":"from","in":"query","required":true,"description":"Start country, ISO code or English name","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"End country, ISO code or English name","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"from":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}},"to":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}},"crossings":{"type":["null","number"]},"passesThrough":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"path":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"LAND_ROUTE_EXISTS","summary":"Portugal to Germany: 3 border crossing(s) via Portugal > Spain > France > Germany.","reasons":[],"from":{"alpha2":"PT","alpha3":"PRT","name":"Portugal"},"to":{"alpha2":"DE","alpha3":"DEU","name":"Germany"},"crossings":3,"passesThrough":[{"alpha2":"ES","alpha3":"ESP","name":"Spain"},{"alpha2":"FR","alpha3":"FRA","name":"France"}],"path":[{"alpha2":"PT","alpha3":"PRT","name":"Portugal"},{"alpha2":"ES","alpha3":"ESP","name":"Spain"}],"degraded":false,"notChecked":["roads, visas, open crossings, security or travel advisories","ferries, bridges and tunnels (for example the UK has no land link to France in this data)","…2 more"],"source":"Embedded country tables (mledoze/countries)","asOf":"2026-10-12T00:54:57.172Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/border-path"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/border-path"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/border-path"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/border-path"}}]}}},"/borders":{"get":{"operationId":"borders","summary":"List a country's land neighbours, or all countries within 2-3 border crossings, with landlocked status.","description":"List a country's land neighbours, or all countries within 2-3 border crossings, with landlocked status.","tags":["countries","borders","geography"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO code or English name, e.g. Germany","schema":{"type":"string"}},{"name":"depth","in":"query","required":false,"description":"Border crossings out to include, 1-3 (default 1)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"country":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}},"landlocked":{"type":["boolean","null"]},"neighbourCount":{"type":["null","number"]},"rings":{"type":["array","null"],"items":{"type":"object","properties":{"crossings":{"type":["null","number"]},"count":{"type":["null","number"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"HAS_LAND_BORDERS","summary":"Germany borders 9 countries: Austria, Belgium, Czechia, Denmark, France, Luxembourg, Netherlands, Poland, Switzerland.","reasons":["Germany has a coastline."],"country":{"alpha2":"DE","alpha3":"DEU","name":"Germany"},"landlocked":false,"neighbourCount":9,"rings":[{"crossings":1,"count":9,"countries":[{"alpha2":"AT","alpha3":"AUT","name":"Austria"},{"alpha2":"BE","alpha3":"BEL","name":"Belgium"}]}],"degraded":false,"notChecked":["maritime boundaries and fixed links such as bridges or tunnels (the UK shows only Ireland)","whether a crossing is open to travellers","…2 more"],"source":"Embedded country tables (mledoze/countries)","asOf":"2026-10-12T00:54:57.429Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/borders"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/borders"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/borders"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/borders"}}]}}},"/countries-filter":{"get":{"operationId":"countries_filter","summary":"List countries by region, currency code, language, driving side, landlocked or UN membership; at least one filter.","description":"List countries by region, currency code, language, driving side, landlocked or UN membership; at least one filter.","tags":["countries","filter","lists"],"parameters":[{"name":"region","in":"query","required":false,"description":"Africa, Americas, Asia, Europe, Oceania or Antarctic","schema":{"type":"string"}},{"name":"subregion","in":"query","required":false,"description":"For example Western Europe or South-Eastern Asia","schema":{"type":"string"}},{"name":"currency","in":"query","required":false,"description":"ISO 4217 code, e.g. EUR","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"Language name or ISO 639-3 code, e.g. Spanish or spa","schema":{"type":"string"}},{"name":"driving","in":"query","required":false,"description":"left or right","schema":{"type":"string"}},{"name":"landlocked","in":"query","required":false,"description":"true or false","schema":{"type":"boolean"}},{"name":"unMember","in":"query","required":false,"description":"true for UN member states","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Max countries returned, 1-250 (default 100)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"filters":{"type":["null","object"],"properties":{"region":{"type":["null","string"]},"driving":{"type":["null","string"]}}},"total":{"type":["null","number"]},"shown":{"type":["null","number"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]},"independent":{"type":["boolean","null"]},"unMember":{"type":["boolean","null"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"MATCHES","summary":"15 countries match {\"region\":\"Africa\",\"driving\":\"left\"}.","reasons":[],"filters":{"region":"Africa","driving":"left"},"total":15,"shown":15,"countries":[{"alpha2":"BW","alpha3":"BWA","name":"Botswana","independent":true,"unMember":true},{"alpha2":"KE","alpha3":"KEN","name":"Kenya","independent":true,"unMember":true}],"degraded":false,"notChecked":["territories and dependencies are included as separate entries (check `independent` and `unMember`)","tables were built on the retrieved date; currency, language and traffic changes after it are not reflected","…1 more"],"source":"Embedded country tables (mledoze/countries, Wikidata)","asOf":"2026-10-12T00:54:57.692Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/countries-filter"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/countries-filter"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/countries-filter"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/countries-filter"}}]}}},"/country-compare":{"get":{"operationId":"country_compare","summary":"Compare two countries: size ratio, border crossings between them, shared currency and language, driving side, distance.","description":"Compare two countries: size ratio, border crossings between them, shared currency and language, driving side, distance.","tags":["countries","compare","geography"],"parameters":[{"name":"a","in":"query","required":true,"description":"First country, ISO code or English name","schema":{"type":"string"}},{"name":"b","in":"query","required":true,"description":"Second country, ISO code or English name","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"a":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]},"region":{"type":["null","string"]},"subregion":{"type":["null","string"]},"areaKm2":{"type":["null","number"]},"landlocked":{"type":["boolean","null"]},"drivingSide":{"type":["null","string"]},"capital":{"type":["array","null"],"items":{"type":"string"}}}},"b":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]},"region":{"type":["null","string"]},"subregion":{"type":["null","string"]},"areaKm2":{"type":["null","number"]},"landlocked":{"type":["boolean","null"]},"drivingSide":{"type":["null","string"]},"capital":{"type":["array","null"],"items":{"type":"string"}}}},"areaRatioAOverB":{"type":["null","number"]},"sharesLandBorder":{"type":["boolean","null"]},"landCrossings":{"type":["null","number"]},"sharedCurrencies":{"type":["array","null"],"items":{"type":"string"}},"sharedLanguages":{"type":["array","null"]},"sameRegion":{"type":["boolean","null"]},"sameDrivingSide":{"type":["boolean","null"]},"centrePointDistanceKm":{"type":["null","number"]},"mutualNeighbours":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NEIGHBOURS","summary":"Germany vs France: they share a land border; shared currency EUR; no shared official language; both drive on the right.","reasons":[],"a":{"alpha2":"DE","alpha3":"DEU","name":"Germany","region":"Europe","subregion":"Western Europe","areaKm2":357114,"landlocked":false,"drivingSide":"right","capital":["Berlin"]},"b":{"alpha2":"FR","alpha3":"FRA","name":"France","region":"Europe","subregion":"Western Europe","areaKm2":551695,"landlocked":false,"drivingSide":"right","capital":["Paris"]},"areaRatioAOverB":0.647,"sharesLandBorder":true,"landCrossings":1,"sharedCurrencies":["EUR"],"sharedLanguages":[],"sameRegion":true,"sameDrivingSide":true,"centrePointDistanceKm":758,"mutualNeighbours":[{"alpha2":"BE","alpha3":"BEL","name":"Belgium"},{"alpha2":"LU","alpha3":"LUX","name":"Luxembourg"}],"degraded":false,"notChecked":["population, economy or culture (not in the tables)","distance is between approximate country centre points, not capitals or borders, and is a great-circle line (R = 6371 km)","…1 more"],"source":"Embedded country tables (mledoze/countries, IANA tz database, Wikidata)","asOf":"2026-10-12T00:54:57.956Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-compare"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-compare"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-compare"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-compare"}}]}}},"/country-profile":{"get":{"operationId":"country_profile","summary":"Country fact sheet by code or name: region, capital, area, borders, currencies, languages, calling code, driving side, zones.","description":"Country fact sheet by code or name: region, capital, area, borders, currencies, languages, calling code, driving side, zones.","tags":["countries","profile","geography"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO alpha-2/alpha-3/numeric code or English name, e.g. DE or Germany","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"numeric":{"type":["null","string"]},"name":{"type":["null","string"]},"officialName":{"type":["null","string"]},"demonym":{"type":["null","string"]},"independent":{"type":["boolean","null"]},"unMember":{"type":["boolean","null"]},"status":{"type":["null","string"]},"region":{"type":["null","string"]},"subregion":{"type":["null","string"]},"capital":{"type":["array","null"],"items":{"type":"string"}},"centrePoint":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"note":{"type":["null","string"]}}},"areaKm2":{"type":["null","number"]},"landlocked":{"type":["boolean","null"]},"borders":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"currencies":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"name":{"type":["null","string"]},"symbol":{"type":["null","string"]}}}},"languages":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"callingCode":{"type":["null","string"]},"internetTld":{"type":["array","null"],"items":{"type":"string"}},"drivingSide":{"type":["null","string"]},"timezones":{"type":["array","null"],"items":{"type":"object","properties":{"zone":{"type":["null","string"]},"area":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Germany (DE/DEU): Western Europe, capital Berlin, 9 land neighbour(s), drives on the right side.","reasons":["Built 2026-10-12 from mledoze/countries (ODbL), the IANA time zone database and Wikidata (CC0)."],"alpha2":"DE","alpha3":"DEU","numeric":"276","name":"Germany","officialName":"Federal Republic of Germany","demonym":"German","independent":true,"unMember":true,"status":"officially-assigned","region":"Europe","subregion":"Western Europe","capital":["Berlin"],"centrePoint":{"lat":51,"lon":9,"note":"approximate centre of the country, not the capital"},"areaKm2":357114,"landlocked":false,"borders":[{"alpha2":"AT","alpha3":"AUT","name":"Austria"},{"alpha2":"BE","alpha3":"BEL","name":"Belgium"}],"currencies":[{"code":"EUR","name":"Euro","symbol":"€"}],"languages":[{"code":"deu","name":"German"}],"callingCode":"+49","internetTld":[".de"],"drivingSide":"right","timezones":[{"zone":"Europe/Berlin","area":"most of Germany"},{"zone":"Europe/Busingen","area":"Busingen"}],"degraded":false,"notChecked":["population, GDP or any statistic (not in the tables)","borders of overseas territories (France shows only its European land borders)","…2 more"],"source":"Embedded country tables (mledoze/countries, IANA tz database, Wikidata)","asOf":"2026-10-12T00:54:58.218Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-profile"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-profile"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-profile"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/country-profile"}}]}}},"/driving-side":{"get":{"operationId":"driving_side","summary":"Which side of the road a country drives on, and which neighbours drive on the other side (switch borders).","description":"Which side of the road a country drives on, and which neighbours drive on the other side (switch borders).","tags":["countries","driving","traffic"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO code or English name, e.g. Thailand","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"country":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}},"drivingSide":{"type":["null","string"]},"sameSideNeighbours":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"oppositeSideNeighbours":{"type":["array","null"],"items":{"type":"object","properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}}},"unknownSideNeighbours":{"type":["array","null"]},"hasSwitchBorder":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"LEFT","summary":"Thailand drives on the left. Traffic switches sides at the border with Myanmar, Cambodia, Laos.","reasons":[],"country":{"alpha2":"TH","alpha3":"THA","name":"Thailand"},"drivingSide":"left","sameSideNeighbours":[{"alpha2":"MY","alpha3":"MYS","name":"Malaysia"}],"oppositeSideNeighbours":[{"alpha2":"MM","alpha3":"MMR","name":"Myanmar"},{"alpha2":"KH","alpha3":"KHM","name":"Cambodia"}],"unknownSideNeighbours":[],"hasSwitchBorder":true,"degraded":false,"notChecked":["local exceptions inside a country (for example territories or special zones)","licence, insurance, speed-limit or vehicle rules","…2 more"],"source":"Embedded country tables (Wikidata P1622 driving side, mledoze/countries borders)","asOf":"2026-10-12T00:54:58.483Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/driving-side"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/driving-side"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/driving-side"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/driving-side"}}]}}},"/time-difference":{"get":{"operationId":"time_difference","summary":"Clock difference in hours between two countries or IANA zones at a given moment, flagging countries with several offsets.","description":"Clock difference in hours between two countries or IANA zones at a given moment, flagging countries with several offsets.","tags":["timezones","time-difference","countries"],"parameters":[{"name":"a","in":"query","required":true,"description":"First country (code or name) or IANA zone, e.g. India or America/New_York","schema":{"type":"string"}},{"name":"b","in":"query","required":true,"description":"Second country or IANA zone, e.g. Japan","schema":{"type":"string"}},{"name":"at","in":"query","required":false,"description":"UTC moment, e.g. 2026-07-15 or 2026-07-15T12:00Z (default now)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"at":{"type":["null","string"]},"a":{"type":["null","object"],"properties":{"label":{"type":["null","string"]},"offsetsMinutes":{"type":["array","null"],"items":{"type":"number"}}}},"b":{"type":["null","object"],"properties":{"label":{"type":["null","string"]},"offsetsMinutes":{"type":["array","null"],"items":{"type":"number"}}}},"differenceMinutes":{"type":["null","number"]},"differenceHours":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"B_AHEAD","summary":"At 2026-01-15T00:00Z, Japan (UTC+09:00) is 3h30 ahead of India (UTC+05:30).","reasons":[],"at":"2026-01-15T00:00:00.000Z","a":{"label":"India","offsetsMinutes":[330]},"b":{"label":"Japan","offsetsMinutes":[540]},"differenceMinutes":210,"differenceHours":3.5,"degraded":false,"notChecked":["legal changes after the runtime's zone rules were built","which zone inside a multi-zone country applies to a city (pass an IANA zone to be exact)","…1 more"],"source":"IANA time zone database (zone.tab) with offsets computed locally from the runtime's zone rules","asOf":"2026-10-12T00:54:58.757Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/time-difference"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/time-difference"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/time-difference"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/time-difference"}}]}}},"/timezones":{"get":{"operationId":"timezones","summary":"IANA time zones for a country with UTC offsets and daylight-saving flags at a given moment (default now).","description":"IANA time zones for a country with UTC offsets and daylight-saving flags at a given moment (default now).","tags":["countries","timezones","utc-offset"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO code or English name, e.g. Australia","schema":{"type":"string"}},{"name":"at","in":"query","required":false,"description":"UTC moment, e.g. 2026-07-15 or 2026-07-15T12:00Z (default now)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"country":{"type":["null","object"],"properties":{"alpha2":{"type":["null","string"]},"alpha3":{"type":["null","string"]},"name":{"type":["null","string"]}}},"at":{"type":["null","string"]},"zoneCount":{"type":["null","number"]},"distinctOffsetsMinutes":{"type":["array","null"],"items":{"type":"number"}},"zones":{"type":["array","null"],"items":{"type":"object","properties":{"zone":{"type":["null","string"]},"area":{},"utcOffsetMinutes":{"type":["null","number"]},"utcOffset":{"type":["null","string"]},"observesDst":{"type":["boolean","null"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"SINGLE_OFFSET","summary":"India has 1 IANA zone(s) with 1 distinct UTC offset(s) at 2026-01-15T00:00Z: Asia/Kolkata UTC+05:30.","reasons":[],"country":{"alpha2":"IN","alpha3":"IND","name":"India"},"at":"2026-01-15T00:00:00.000Z","zoneCount":1,"distinctOffsetsMinutes":[330],"zones":[{"zone":"Asia/Kolkata","area":null,"utcOffsetMinutes":330,"utcOffset":"UTC+05:30","observesDst":false}],"degraded":false,"notChecked":["legal changes after the table and runtime were built (governments change daylight-saving rules with little notice)","which zone a given city or address falls in (zone.tab lists areas, not boundaries)","…2 more"],"source":"IANA time zone database (zone.tab) with offsets computed locally from the runtime's zone rules","asOf":"2026-10-12T00:54:59.009Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/timezones"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/timezones"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/timezones"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://country-facts.x402tookit.com/timezones"}}]}}}}}