---
title: "Resolve Local Timezone Offset"
method: POST
path: "/v2/timezone/resolve"
tags: ["locations-v2"]
---

# Resolve Local Timezone Offset

`POST /v2/timezone/resolve`

## Request

- Base URL: `https://api.humandesignhub.app`
- URL: `https://api.humandesignhub.app/v2/timezone/resolve`
- Auth: API key in header `X-API-KEY`

Converts an offset-free local birth datetime plus an IANA timezone ID into the ISO-8601 datetime with UTC offset expected by chart calculation endpoints.

## Request body

- TimezoneResolveRequest
  - `timezone` string, required: IANA timezone ID (예: Asia/Seoul)
  - `date` string, nullable: 로컬 날짜 YYYY-MM-DD
  - `time` string, nullable: 로컬 시간 HH:MM 또는 HH:MM:SS
  - `local_datetime` string, nullable: 오프셋 없는 로컬 ISO datetime (예: 1990-05-12T14:30:00)
  - `disambiguation` 'earlier' | 'later' | 'reject': DST fall-back처럼 같은 local time이 두 번 존재할 때 선택할 offset

## Response `200`

Successful Response

- TimezoneResolveResponse
  - `datetime` string, required: 차트 API에 바로 전달 가능한 ISO datetime
  - `local_datetime` string, required: 입력 로컬 datetime
  - `timezone` string, required: IANA timezone ID
  - `utc_offset` string, required: UTC offset 문자열
  - `offset_minutes` integer, required: UTC offset 분 단위
  - `ambiguous` boolean: DST fall-back 등으로 local time이 중복되는지 여부
  - `disambiguation_used` 'earlier' | 'later', nullable
  - `alternatives` TimezoneAlternative[]
    - `disambiguation` 'earlier' | 'later', required
    - `datetime` string, required
    - `utc_offset` string, required
    - `offset_minutes` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/humandesignhub/apis/human-design-hub-pro-api.md) · [All operations](https://skmtc.dev/humandesignhub/apis/human-design-hub-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/humandesignhub/apis/human-design-hub-pro-api/revisions/c2681d2ac216?raw)