Skip to main content
POST
Returns timezone information for one or more North America phone numbers

Response Fields

Every input phone produces exactly one row in the response. Inspect Status to decide how to handle each row.

Status Values

Per-row Status replaces the older behavior where a single bad phone caused the entire batch to return HTTP 400. The endpoint now returns 200 with one row per input phone; inspect Status to decide which rows are usable. HTTP 400 is still returned for batch-level errors (missing body, empty list, more than 1000 phones).

Headers

loginId
string

LoginId (aka APIKey)

Body

Object of phone numbers whose timezones we query

PhoneList
string[] | null
OverwriteTodaysTime
string<date-time> | null

Response

Success

PhoneNumber
string | null
TZName
string | null
StateProvince
string | null
UTCOffset
string | null
UTCOffsetInMinutes
integer<int32>
HasDST
boolean
NextStartDateDST
string<date-time> | null
EndStartDateDST
string<date-time> | null
LATA
string | null
RateCenterLIR
string | null