Timezone API
Find, convert, and manage time and timezone data across the world. Supports lookup by location or coordinates and returns local time, timezone abbreviation, UTC offset, and DST information.
OpenAPI Specification
openapi: 3.0.3
info:
title: Abstract API - Timezone API
description: Find, convert, and manage time and timezone data across the world. Supports lookup by location or coordinates and returns local time, timezone abbreviation, UTC offset, and DST information.
version: 1.0.0
contact:
url: https://www.abstractapi.com/
x-generated-from: documentation
servers:
- url: https://timezone.abstractapi.com/v1
description: Timezone API v1
security:
- apiKey: []
tags:
- name: Timezones
description: Timezone lookup and conversion operations
paths:
/current_time:
get:
operationId: getCurrentTime
summary: Abstract API Get Current Time
description: Get the current time, date, and timezone for a location specified by name, coordinates, or IP address.
tags:
- Timezones
parameters:
- name: api_key
in: query
required: true
description: Your unique API key for the Timezone API.
schema:
type: string
example: abc123def456
- name: location
in: query
required: false
description: Location name (e.g., city, address). Use location, latitude+longitude, or ip_address.
schema:
type: string
example: New York City
- name: latitude
in: query
required: false
description: Latitude coordinate. Used with longitude.
schema:
type: number
format: double
example: 40.7128
- name: longitude
in: query
required: false
description: Longitude coordinate. Used with latitude.
schema:
type: number
format: double
example: -74.006
- name: ip_address
in: query
required: false
description: IP address to determine timezone from.
schema:
type: string
example: 8.8.8.8
responses:
'200':
description: Current time and timezone information
content:
application/json:
schema:
$ref: '#/components/schemas/CurrentTimeResponse'
examples:
getCurrentTime200Example:
summary: Default getCurrentTime 200 response
x-microcks-default: true
value:
datetime: '2026-04-19 10:30:00'
timezone_name: America/New_York
timezone_location: New York, United States
timezone_abbreviation: EDT
gmt_offset: -4
is_dst: true
requested_location: New York City
latitude: 40.7128
longitude: -74.006
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/convert_time:
get:
operationId: convertTime
summary: Abstract API Convert Time Between Timezones
description: Convert time from one location to another, or convert to and from UTC.
tags:
- Timezones
parameters:
- name: api_key
in: query
required: true
description: Your unique API key.
schema:
type: string
example: abc123def456
- name: base_location
in: query
required: true
description: Source location name or coordinates.
schema:
type: string
example: London
- name: base_datetime
in: query
required: false
description: Date and time to convert (YYYY-MM-DD HH:MM:SS). Defaults to current time.
schema:
type: string
example: '2026-04-19 10:30:00'
- name: target_location
in: query
required: true
description: Target location name or coordinates.
schema:
type: string
example: Tokyo
responses:
'200':
description: Time conversion result
content:
application/json:
schema:
$ref: '#/components/schemas/ConvertTimeResponse'
examples:
convertTime200Example:
summary: Default convertTime 200 response
x-microcks-default: true
value:
base_location: London
base_datetime: '2026-04-19 10:30:00'
base_timezone_name: Europe/London
base_timezone_abbreviation: BST
base_utc_offset: 1
target_location: Tokyo
target_datetime: '2026-04-19 18:30:00'
target_timezone_name: Asia/Tokyo
target_timezone_abbreviation: JST
target_utc_offset: 9
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
securitySchemes:
apiKey:
type: apiKey
in: query
name: api_key
schemas:
CurrentTimeResponse:
type: object
description: Current time and timezone data for a location
properties:
datetime:
type: string
description: Current date and time in the target timezone
example: '2026-04-19 10:30:00'
timezone_name:
type: string
description: IANA timezone name
example: America/New_York
timezone_location:
type: string
description: Human-readable location description
example: New York, United States
timezone_abbreviation:
type: string
description: Timezone abbreviation
example: EDT
gmt_offset:
type: integer
description: GMT/UTC offset in hours
example: -4
is_dst:
type: boolean
description: Whether daylight saving time is active
example: true
requested_location:
type: string
description: The input location string
example: New York City
latitude:
type: number
format: double
description: Latitude of the location
example: 40.7128
longitude:
type: number
format: double
description: Longitude of the location
example: -74.006
ConvertTimeResponse:
type: object
description: Time zone conversion result
properties:
base_location:
type: string
description: Source location
example: London
base_datetime:
type: string
description: Input date and time
example: '2026-04-19 10:30:00'
base_timezone_name:
type: string
description: Source IANA timezone name
example: Europe/London
base_timezone_abbreviation:
type: string
description: Source timezone abbreviation
example: BST
base_utc_offset:
type: integer
description: Source UTC offset in hours
example: 1
target_location:
type: string
description: Target location
example: Tokyo
target_datetime:
type: string
description: Converted date and time
example: '2026-04-19 18:30:00'
target_timezone_name:
type: string
description: Target IANA timezone name
example: Asia/Tokyo
target_timezone_abbreviation:
type: string
description: Target timezone abbreviation
example: JST
target_utc_offset:
type: integer
description: Target UTC offset in hours
example: 9
ErrorResponse:
type: object
properties:
message:
type: string
example: The provided API key is invalid
error:
type: string
example: invalid_api_key