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

phoneNumbers

string[]

required

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

overwriteTodaysTime

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

success

boolean

Whether the API call succeeded.

results

array

Array of results, one per phone number.

Show result object

phone

string

The phone number checked.

timezone

string

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

state

string

2-letter state/province code.

utcOffset

string

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

utcOffsetMinutes

number

UTC offset in minutes.

hasDST

boolean

Whether this timezone observes daylight saving time.

dstStartDate

string | null

Next DST start date.

dstEndDate

string | null

Next DST end date.

lata

string

Local Access Transport Area code.

rateCenter

string

Rate center / LIR info.

errorCode

string

Machine-readable error code (when failed).

errorMessage

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

MCP Server for AI Applications

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes