Resolve Birth Instant API
AvailableTurns an IANA zone plus local date and time into one UTC instant, or reports that the local time was ambiguous (both candidates returned) or nonexistent across a DST change.
Call it with POST /v1/utilities/resolve-instant. Input: specific input. Output: JSON, as a direct response. Each successful call costs 1 credit.
- Endpoint
- POST /v1/utilities/resolve-instant
- Input
- Specific input
- Output
- JSON
- Delivery
- Direct response
- Cost
- 1 credit
- Compute class
- Light
Example response
Fields in data (inferred from the example)
timezone· stringlocal_date· stringlocal_time· stringstatus· stringutc_offset· nullabbreviation· nullutc· nullcandidates· array of object
Example response
Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.
Loading the example…
Request schema and every field: the Utilities reference.
Resolve Birth Instant API: common questions
What does the Resolve Birth Instant API return?
Turns an IANA zone plus local date and time into one UTC instant, or reports that the local time was ambiguous (both candidates returned) or nonexistent across a DST change. The response's data object includes timezone, local_date, local_time, status, utc_offset, abbreviation, utc and candidates. See the reference for an example response.
What input does Resolve Birth Instant need?
Specific input.
How much does a Resolve Birth Instant call cost?
1 credit per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.
Can I try it before paying?
Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.