Skip to content
    TimeLogic API logoTimeLogic API
    Sign in
    Endpoint guide

    Convert time

    GET /v1/time/convertOpenAPI YAML

    Convert one input timestamp into a target timezone, offset, IP, coordinate, or UTC. Supports bulk targets.

    What do I need to send?

    Required / choose this first

    Send exactly one input (unix, unix_ms, or iso) and exactly one target (tz, ip, lat + lon, offset, or utc).

    Optional

    source_* fields explain a local ISO value; format and sign are optional.

    Rule: Bulk conversion is available with one comma-separated tz, ip, or offset target.

    NameNeeded?Use it for
    unixChoose one inputInput timestamp as Unix seconds.
    unix_msChoose one inputInput timestamp as Unix milliseconds.
    isoChoose one inputInput timestamp as ISO 8601. May include offset (e.g. ...Z) or be local with a source_* hint.
    source_tzConditional hintInterpret a local iso= as wall time in this IANA zone.
    source_ipConditional hintInterpret local iso= using the timezone of this IP.
    source_latPair parameterLatitude for local iso= zone resolution. Pair with source_lon.
    source_lonPair parameterLongitude for local iso= zone resolution.
    source_offsetConditional hintInterpret local iso= against a fixed UTC offset.
    tzChoose one targetTarget IANA timezone. Comma-separated for bulk.
    ipChoose one targetTarget via IP address. Comma-separated for bulk.
    latPair parameterTarget latitude. Pair with lon.
    lonPair parameterTarget longitude.
    offsetChoose one targetTarget fixed UTC offset. URL-encode + as %2B. Comma-separated for bulk.
    utcChoose one targetSet true to render the target in UTC.
    formatOptionalstrftime pattern for the additional `formatted` field, e.g. %Y-%m-%d %H:%M:%S.
    signOptionalSet true for a signed response.

    Code samples

    Copy a request in your preferred language and replace YOUR_TIMELOGIC_API_KEY with your direct API key.

    curl "https://api.timelogicapi.com/v1/time/convert?unix=1711300000&tz=Europe/London" \
  -H "Authorization: Bearer $TIMELOGIC_API_KEY"

    Example response

    {
  "unix": 1711300000,
  "unix_ms": 1711300000000,
  "utc": "2024-03-24T17:06:40Z",
  "iso_local": "2024-03-24T17:06:40+00:00",
  "rfc2822": "Sun, 24 Mar 2024 17:06:40 +0000",
  "human": "March 24, 2024, 5:06 PM Europe/London",
  "day_number": 1,
  "day_short": "Sun",
  "day_full": "Sunday",
  "timezone": "Europe/London"
}
    Additional endpoint notes

    Provide exactly one input timestamp form (unix, unix_ms, or iso) and exactly one target selector family.

    # Numeric input → named zone
curl "https://api.timelogicapi.com/v1/time/convert?unix=1711300000&tz=Europe/London" \
  -H "Authorization: Bearer $TIMELOGIC_API_KEY"

# Local ISO with source zone hint
https://api.timelogicapi.com/v1/time/convert?iso=2026-04-16T09:00:00&source_tz=America/New_York&tz=Europe/London

# Bulk targets — one comma-separated selector
https://api.timelogicapi.com/v1/time/convert?unix=1711300000&offset=-04:00,%2B00:00,%2B09:00

# strftime
https://api.timelogicapi.com/v1/time/convert?unix=1711300000&tz=Europe/London&format=%25Y-%25m-%25d%20%25H:%25M:%25S
# → adds "formatted": "2024-03-24 17:06:40"

    Bulk response — array of payloads, one per target, in input order.

    Common errors

    • 400 INVALID_TIMESTAMP — no input timestamp provided.
    • 400 MISSING_TARGET — no target selector / utc=true provided.
    • 400 AMBIGUOUS_TARGET — multiple input or target families combined, or a bulk selector mixed with another target (including utc=true).
    • 400 INVALID_PARAMETER — invalid timezone, offset, or strftime directive.

    When to use this endpoint

    Use Convert time when you already have a source timestamp and need to project it into another timezone, fixed offset, IP-derived zone, coordinate-derived zone, or UTC. It is designed for meeting planners, notification systems, travel tools, and scheduling interfaces.

    Request model

    Provide exactly one input timestamp (unix, unix_ms, or iso). If an ISO value is a local wall time without an embedded offset, add one source hint such as source_tz so TimeLogic can interpret that wall time safely before converting it.

    Bulk targets

    Bulk conversion is useful for world clocks and availability screens. Send comma-separated target selectors in one target family to get an array of converted values in the same order as the input list.