dropframe.app Global Timecode · API Open the app →
Developers

The Global Timecode, as an API

Lock any device, camera, or app to one UTC-accurate clock over plain HTTPS. One endpoint, a free key, and an honest millisecond accuracy readout on every response. It's the same public clock the DropFrame apps lock to — now callable from your own code.

The endpoint

A single read. The nearest edge answers automatically — no region to pick.

# the current agreed instant + how far it may be from true UTC
GET https://time.dropframe.app/v1/now?key=YOUR_KEY
{
  "v": 1,
  "epochMs": 1750000000123,   // server time at request receipt (ms since 1970 UTC)
  "disp": 8,                 // how far this may be from true UTC (ms) — the honesty bound
  "dispSource": "measured", // "measured" or "assumed" — we tell you which
  "leapOffset": 37,          // TAI − UTC, for the SMPTE / PTP timescale
  "edge": "EWR"            // which edge served you (transparency)
}

Response fields

FieldMeaning
epochMsThe agreed instant, in milliseconds since 1970 UTC, stamped at request receipt.
dispThe dispersion — how far epochMs may be from true UTC, in ms. Smaller is tighter.
dispSourcemeasured (from an out-of-band monitor) or assumed (a conservative fallback). We never pretend a number we haven't measured.
leapOffsetTAI − UTC (currently 37), for building an SMPTE / PTP timescale.
edgeWhich edge location answered — purely for transparency.

Also: GET /v1/health → a liveness check. Time responses are never cached.

Get a free key

A free key is required for programmatic access. Sign in with just your email — no password. No account yet? We'll create one automatically.

Sign in to generate a key — it's free
We'll email a one-time sign-in link — no password. The same account unlocks downloads, streaming, and MIDI output in the app too.
One key is plenty — it works from any device. Keep it to yourself.

Sending your key

Any one of these — whichever suits your client:

# query parameter
GET /v1/now?key=df_your_key

# request header
X-DropFrame-Key: df_your_key

# bearer token
Authorization: Bearer df_your_key

Every response includes X-DropFrame-Plan and, on the free tier, X-DropFrame-Quota-Remaining.

Tiers

Free

Public clock

Free · sign in for a key
  • The shared Global Timecode over HTTPS
  • Millisecond-class position reference
  • Live measured accuracy on every response
  • Fair-use rate limits
Honest about precision: this is a millisecond-level position reference over the open internet — ideal for keeping devices and crews aligned across locations. It is not sample-accurate genlock; the disp field tells you the real bound, live, on every call.

License & terms

Free to use — not open source. The Global Timecode service, this API, and all DropFrame client code are proprietary, all rights reserved. Your API key grants you a personal, revocable, non-transferable right to call the hosted API within the fair-use limits — nothing more. No license is granted to the software itself: don't copy, mirror, resell, redistribute, reverse-engineer, or rehost the service or any DropFrame code, and don't present the reference as your own. "Free" describes the price of the hosted service, not a grant of rights to the source. Keys and access may be revoked for abuse. Questions: [email protected].