osrmroute-com Timezone API

openapi: 3.2.0
info:
  title: OSRMRoute Timezone API
  version: 1.1.0
  description: 'OSRMRoute — Maps, Routing, Truck Routing, Search, Road Data, Studio and integration APIs. Use `Authorization: Bearer ` unless an operation documents another flow. Legacy APIs also accept the key query parameter; New geospatial APIs, MCP and private map delivery require Bearer authentication. Mobile challenge/token endpoints use device attestation instead. Coordinates and units are documented per operation: GeoJSON uses longitude,latitude; some legacy and background-job inputs use latitude,longitude. Examples are illustrative, not guaranteed current results. Guides · Mobile Access · MCP · Postman collection.'
  contact:
    name: OSRMRoute Support
    url: https://osrmroute.com/contact
    email: support@osrmroute.com
  termsOfService: https://osrmroute.com/terms
servers:
- url: https://osrmroute.com
security:
- bearerAuth: []
- apiKeyQuery: []
tags:
- name: Timezone API
paths:
  /api/1/timezone:
    get:
      tags:
      - Timezone API
      summary: Timezone API
      description: The Timezone API returns the IANA time zone (e.g. Asia/Baku) for any coordinate worldwide, along with the current UTC offset, whether daylight saving is in effect, the zone abbreviation and the local time. Pass an optional timestamp to resolve the offset for a past or future moment. Backed by a global dataset — it works anywhere, not just our map coverage.
      operationId: get_timezone
      parameters:
      - name: point
        in: query
        required: true
        description: Coordinate as lat,lng.
        schema:
          type: string
        example: 40.3755,49.8516
      - name: lat
        in: query
        required: false
        description: Latitude (alternative to point).
        schema:
          type: number
        example: 40.3755
      - name: lon
        in: query
        required: false
        description: Longitude (alternative to point).
        schema:
          type: number
        example: 49.8516
      - name: timestamp
        in: query
        required: false
        description: Unix time (seconds) or ISO date to resolve the offset for; defaults to now.
        schema:
          type: integer
        example: now
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              examples:
                success:
                  summary: Illustrative abbreviated response; values vary with input and map data.
                  value:
                    timezone: Asia/Baku
                    point:
                      lat: 40.3777
                      lng: 49.8516
                    utc_offset: +04:00
                    utc_offset_seconds: 14400
                    dst: false
                    abbreviation: GMT+4
                    local_time: '2026-01-01T16:00:00'
                    utc_time: '2026-01-01T12:00:00.000Z'
        '400':
          description: Error Codes (HTTP 400)
          content:
            application/json:
              examples:
                invalid:
                  value:
                    error: Provide a valid coordinate via point=lat,lng or lat= & lon=.
        '401':
          description: Error Codes (HTTP 401)
          content:
            application/json:
              examples:
                auth:
                  value:
                    error: Invalid API Key
        '402':
          description: Error Codes (HTTP 402)
          content:
            application/json:
              examples:
                balance:
                  value:
                    error: 'Insufficient balance: this request costs 1 credit and your balance is 0 credits. Top up your account to continue.'
        '403':
          description: Error Codes (HTTP 403)
          content:
            application/json:
              examples:
                plan:
                  value:
                    error: This API Key is disabled
        '429':
          description: Error Codes (HTTP 429)
          content:
            application/json:
              examples:
                rate:
                  value:
                    error: 'Rate limit exceeded: more than 60 requests per minute. Please slow down.'
        '500':
          description: Error Codes (HTTP 500)
          content:
            application/json:
              examples:
                upstream:
                  value:
                    error: Internal Server Error
      x-credit-cost: 1 credit
      x-request-limits:
      - 'timestamp: Unix seconds | ISO 8601; default = now'
      - 'utc_offset_seconds: seconds'
components:
  securitySchemes:
    apiKeyQuery:
      type: apiKey
      in: query
      name: key
    bearerAuth:
      type: http
      scheme: bearer