Hosted developer API

TimeNivo REST API v1.1

Versioned HTTPS endpoints for server applications and production integrations. Authentication uses the X-API-Key request header.

Create or manage a keyOpen OpenAPI 3.1 JSON
Current specification

Endpoint families

The deployed OpenAPI description is the source of truth for parameters and response schemas.

GET /v1/time

Current time and zone metadata.

GET /v1/time-difference

Difference between zones.

GET /v1/convert

Convert a wall time or instant.

GET /v1/dst-transitions

Offset transitions.

GET /v1/holidays

Published holiday data.

GET /v1/business-days

Business-day calculation.

GET /v1/working-hours-overlap

Overlap windows.

POST /v1/meeting-score

Score one meeting candidate.

POST /v1/best-meeting-slots

Rank candidate slots.

POST /v1/batch-convert

Batch conversion.

GET /v1/city-search

Search supported cities.

GET /v1/timezone-at-coordinate

Coordinate boundary lookup.

Authentication

Send your API key

curl --request GET \
  --url 'https://timenivo.com/v1/time?zone=Africa%2FCairo' \
  --header 'X-API-Key: YOUR_KEY'

Never embed a private server key in public client-side JavaScript. Use the Browser API for no-key front-end calculations.