worldtime-api/openapi.yaml at main · apiverve/worldtime-api · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
openapi: 3.0.4
info:
  title: World Time
  description: >-
    World Time looks up the current local time, date, and timezone for any city.
    Search by city name to get matching locations with country codes, IANA
    timezone identifiers, and formatted times in 12-hour and 24-hour formats.
  termsOfService: https://apiverve.com/terms/
  contact:
    name: APIVerve Support
    email: hello@apiverve.com
    url: https://apiverve.com/contact
  version: 1.0.0
externalDocs:
  description: Learn more about APIVerve
  url: https://docs.apiverve.com?utm_source=openapi
servers:
  - url: https://api.apiverve.com/
paths:
  /v1/worldtime:
    get:
      summary: World Time
      description: Get the current time in any city
      operationId: worldtime
      parameters:
        - name: city
          in: query
          schema:
            type: string
          required: true
          description: >-
            The city name for which you want to get the current time (e.g., New
            York)
          example: San Francisco
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: status
                  error:
                    type: string
                    description: error
                  data:
                    type: object
                    description: data
              example:
                status: ok
                error: null
                data:
                  search: San Francisco
                  foundCities:
                    - city: San Francisco
                      city_ascii: San Francisco
                      country: Argentina
                      iso2: AR
                      iso3: ARG
                      province: Córdoba
                      timezone: America/Argentina/Cordoba
                      time: '19:33'
                      time24: '19:33:04'
                      time12: 07:33:04 PM
                      date: '2025-12-16'
                      day: Tuesday
                      month: December
                      year: '2025'
                      unix: '1765924384'
                      dst: false
                      dst_start: '2025-12-16 19:33:04'
                      dst_end: '2025-12-16 19:33:04'
                      dst_name: '-03'
                    - city: San Francisco
                      city_ascii: San Francisco
                      country: United States of America
                      iso2: US
                      iso3: USA
                      province: California
                      state_ansi: CA
                      timezone: America/Los_Angeles
                      time: '14:33'
                      time24: '14:33:04'
                      time12: 02:33:04 PM
                      date: '2025-12-16'
                      day: Tuesday
                      month: December
                      year: '2025'
                      unix: '1765924384'
                      dst: false
                      dst_start: '2025-12-16 14:33:04'
                      dst_end: '2025-12-16 14:33:04'
                      dst_name: PST
        '401':
          description: Your request was not authorized, or your API Key was invalid
        '404':
          description: Requested resource was not found
        '500':
          description: A server error has occurred, try again later
components:
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header
security:
  - api_key: []