All APIs Syndaq Timezone

Data API

Know a visitor's timezone from their IP.

Resolve IANA timezone ID, UTC offset, and abbreviation for any public IP—plus country and city when available. Ideal for scheduling, localised messaging, and analytics.

At a glance

  • 3 REST endpoints
  • JSON Request & response
  • HTTPS TLS required
  • Free tier available Starting price

Use cases

Where teams use Syndaq Timezone

Scheduling

Suggest meeting times in the visitor's local zone without asking them first.

Localised messaging

Send notifications during reasonable local hours.

Analytics

Bucket events by timezone for product and support insights.

Default locales

Pre-select locale and clock format based on network location.

Integration

Up and running in three steps

1

Get an API key

Subscribe to a Timezone plan and copy your tz_sec_ secret key from the client area.

2

Look up the IP

Pass any public IPv4 or IPv6 address by path or query parameter.

3

Use timezone.id

Apply the IANA ID and offset in scheduling and display logic.

Example

Copy, paste, ship

Every response includes a request_id for support correlation. Rate limit and quota headers are returned on authenticated routes so you can backoff gracefully.

Authenticated with your Syndaq secret key over HTTPS. Private and reserved IPs return a clear error and are not billed.

Request
curl -s "https://api.syndaq.com/v1/timezone/lookup/8.8.8.8" \
  -H "Authorization: Bearer tz_sec_YOUR_SECRET_KEY"
Response
{
  "success": true,
  "ip": "8.8.8.8",
  "cached": true,
  "timezone": {
    "id": "America/Los_Angeles",
    "utc_offset": "-07:00",
    "abbreviation": "PDT"
  },
  "country": { "code": "US" },
  "city": "Mountain View",
  "request_id": "d5e6f78901234567890123456789ef"
}

Reference

API endpoints

Included with your Syndaq Timezone plan.

Method Path Description
GET /v1/timezone/lookup Lookup timezone by ?ip= query parameter.
GET /v1/timezone/lookup/{ip} Lookup timezone for an IP in the URL path.
GET /v1/timezone/status Returns plan limits and quota for the authenticated key.

Pricing

Plans for every stage

Transparent limits. Upgrade when your traffic grows—no surprise overages without a plan change.

Starter

Free

Development and light production lookups.

  • 120 requests / minute
  • 10,000 lookups / month
  • Secret key authentication
  • Timezone from IP JSON REST API
  • Timezone ID & UTC offset
  • Rate limit & quota headers
Get started

Enterprise

monthly
$99.00 USD

High-volume lookups with priority limits.

  • 3,000 requests / minute
  • Unlimited monthly lookups
  • Secret key authentication
  • Timezone from IP JSON REST API
  • Timezone ID & UTC offset
  • Rate limit & quota headers
Get started

FAQ

Common questions

Send your tz_sec_ secret key as a Bearer token in the Authorization header on every request to https://api.syndaq.com.

timezone.id (IANA), utc_offset, abbreviation, plus country code and city when available.

Yes. Plans include per-minute rate limits and monthly quotas with standard X-RateLimit and X-Quota response headers.

Ready to integrate Syndaq Timezone?

Pick a plan, create your keys in the client area, and start calling the API in minutes.

Choose a plan Ask a question