get_timezone_info Tool - Contact Center Compliance

The get_timezone_info tool returns timezone and location information for North American phone numbers. Use this to determine local time before calling.

When to Use

Determining the local time at a phone number’s location
Planning call schedules across multiple time zones
Ensuring calls are made during appropriate hours

Parameters

string[]

required

List of 10-digit North American phone numbers (e.g., ["5039367187", "2125551234"]).

string

Optional ISO 8601 datetime to use instead of current time for DST calculations.

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

Response

boolean

Whether the API call succeeded.

array

Array of results, one per phone number.

Show result object

string

The phone number checked.

string

Timezone name (e.g., America/Los_Angeles).

string

2-letter state/province code.

string

UTC offset string (e.g., -08:00).

number

UTC offset in minutes.

boolean

Whether this timezone observes daylight saving time.

string | null

Next DST start date.

string | null

Next DST end date.

string

Local Access Transport Area code.

string

Rate center / LIR info.

string

Machine-readable error code (when failed).

string

Human-readable error description (when failed).

Examples

Request
Response

{
  "phoneNumbers": ["5039367187", "2125551234"]
}

{
  "success": true,
  "results": [
    {
      "phone": "5039367187",
      "timezone": "America/Los_Angeles",
      "state": "OR",
      "utcOffset": "-08:00",
      "utcOffsetMinutes": -480,
      "hasDST": true,
      "dstStartDate": "2024-03-10",
      "dstEndDate": "2024-11-03",
      "lata": "672",
      "rateCenter": "PORTLAND"
    },
    {
      "phone": "2125551234",
      "timezone": "America/New_York",
      "state": "NY",
      "utcOffset": "-05:00",
      "utcOffsetMinutes": -300,
      "hasDST": true,
      "dstStartDate": "2024-03-10",
      "dstEndDate": "2024-11-03",
      "lata": "132",
      "rateCenter": "NEW YORK"
    }
  ]
}

Usage Notes

Batch multiple numbers in a single request for efficiency
Use utcOffsetMinutes for programmatic time calculations
DST dates help plan for time changes
For real-time “can I call now?” checks, use is_time_legal_to_call instead

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes