{"uid":"cap_fBxd2vZ-fnPrED2M42wF6","slug":"country-facts-time-difference-f84cbf2e","name":"Country Facts Time Difference","description":"Clock difference in hours between two countries or IANA zones at a given moment, flagging countries with several offsets.","url":"https://country-facts.x402tookit.com/time-difference?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["a","b"],"properties":{"a":{"type":"string","description":"First country (code or name) or IANA zone, e.g. India or America/New_York"},"b":{"type":"string","description":"Second country or IANA zone, e.g. Japan"},"at":{"type":"string","description":"UTC moment, e.g. 2026-07-15 or 2026-07-15T12:00Z (default now)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"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"}}}},"at":{"type":["null","string"]},"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"differenceHours":{"type":["null","number"]},"differenceMinutes":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wNcMcGLsflfBREAt22NGU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the clock difference in hours and minutes between two countries or IANA time zones at a specified moment, with warnings for countries spanning multiple offsets.","exampleAgentPrompt":"What's the time difference between India and Japan right now — and does either country have multiple time zones I should know about?","exampleUseCases":[{"title":"Scheduling international team standup","prompt":"I need to schedule a meeting between our New York office and our Tokyo office on July 15, 2026 at noon New York time — what's the hour difference between America/New_York and Japan so I can tell the Tokyo team what local time to join?"},{"title":"Checking offset for live event broadcast","prompt":"We're broadcasting a live event from Germany on August 3rd 2026 at 8pm local time — how many hours difference is there between Germany and Brazil so we can tell our Brazilian audience when to tune in?"},{"title":"Flagging multi-offset countries before scheduling","prompt":"Before I set up a call with colleagues spread across the US and India next Monday, can you tell me the time difference between the United States and India and flag if either country has more than one time zone in use?"}],"resultDescription":"Returns a JSON object containing: the clock difference in hours and minutes between the two locations (differenceHours, differenceMinutes), the UTC offsets in minutes for each location (offsetsMinutes), human-readable labels for each zone (label), the resolved timestamp (at, asOf), a plain-English summary and verdict, any reasons flagging complexity (e.g. multi-offset countries), a degraded flag if the result is approximate, a disclaimer, and a list of anything not checked (notChecked).","failureModes":["Unrecognized country name or code returns null entries for that location","Country spanning multiple time zones returns an array of offsets rather than a single value, with reasons flagging the ambiguity","Invalid datetime string for 'at' parameter may cause parsing failure or default to current time","IANA zone not found returns null offset data","Network or upstream data errors may set degraded=true with a disclaimer"],"whenToPreferThis":"Use this endpoint when you need a quick, authoritative clock offset between two countries or IANA time zones at a specific moment — especially when you want automatic flagging of multi-offset countries (like the US, Russia, or Brazil) that could complicate scheduling. Prefer it over generic world-clock APIs when you want both a numeric difference and a human-readable verdict with contextual warnings in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:13:43.174Z","isFirstParty":false,"canonicalSlug":"country-facts-time-difference-f84cbf2e"}