Time Zone by IP Address API
This API returns the same time zone information as the Time Zone Info API — IANA time zone identifier, UTC offset, daylight saving time status, and current local time — but resolved automatically from an IPv4 or IPv6 address rather than requiring you to know the time zone identifier upfront.
It's a convenient single-call option when you have an IP address and need local time context without a separate geolocation step.
GET
https://api-bdc.net/data/timezone-by-ipParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ip | string | Optional | IPv4 IP address in a string or numeric format or IPv6 IP address in a string format. If omitted, the caller’s IP address is assumed |
utcReference | integer (int64) | Optional | UTC time reference in Unix Time Seconds format. When omitted or invalid, the current time is assumed |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/timezone-by-ip?ip=98.82.119.241&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
ianaTimeIdstringThe unique identifier of the time zone from the IANA Time Zone Database (e.g., "America/New_York").
displayNamestringThe user-friendly display name for the time zone (e.g., "(UTC-05:00) Eastern Time (US & Canada)").
effectiveTimeZoneFullstringThe full name of the effective time zone, adjusted for daylight saving (e.g., "Eastern Daylight Time").
effectiveTimeZoneShortstringThe abbreviated name of the effective time zone, adjusted for daylight saving (e.g., "EDT").
utcOffsetSecondsintegerThe effective offset from UTC in seconds, adjusted for daylight saving time.
utcOffsetstringThe effective offset from UTC, formatted as a string and adjusted for daylight saving time.
isDaylightSavingTimebooleanA boolean value indicating whether daylight saving time is currently in effect.
localTimestringThe current local time in the specified time zone, formatted in ISO 8601 "O" format.
utcTimestringThe corresponding UTC time, formatted in ISO 8601 "O" format. This value is omitted if the 'utcReference' parameter was not supplied or was invalid.
403Access denied, or your quota limit has exceeded
Sample Response
JSON View
404Found no valid entry for the request
Sample Response
JSON View
405The requested IP address is not valid
Sample Response
JSON View
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View