API docs
Call the API with a workspace ID in the path. These examples use the public demo-basic demo workspace until you sign in and replace it with your own ID.
Backend request signing
For backend calls, sign requests with the signing key from your workspace settings.
Signature formula: base64url(hmac_sha256("GET\n" + full_path + "\n" + timestamp_ms))
full_path is the path starting with /api, including the query stringtimestamp_ms is current Unix time in milliseconds (max 5 min skew)Send these headers with your request:
X-Signature is the result of the formula aboveX-Signature-Timestamp is timestamp_msUnsigned calls must come from your allowed domains or IPs. The demo workspace allows this docs site.
GET
Return the current date/time value for the entity in the requested format.
Path params
| tenant | Workspace ID in the path. Examples use demo-basic. |
| entity | One of date, time, datetime, timestamp, iso. |
| format | Optional. Defaults to text. One of text, json, yaml, xml or js. |
Query params
| tz | Integer UTC offset, e.g. -5 or 2. Defaults to the edge timezone's current offset. |
| locale | BCP 47 locale metadata returned in structured responses. Defaults to Accept-Language. |
| precision | One of year, month, day, hour, minute, second (entity-dependent). |
| custom | Custom pattern using YYYY, MM, DD, HH, mm, ss. Overrides precision. |
| cache | off/none/false/0 to bypass edge cache (still consumes quota). |
Request example
curl "https://getnow.date/api/demo-basic/get/date.json?tz=2"Examples use demo-basic. Sign in to replace it with your workspace ID.
Response
{
"entity": "date",
"value": "2025-02-01",
"iso": "2025-02-01T12:00:00.000Z",
"unix": 1738411200,
"datetime": "2025-02-01 12:00:00",
"locale": "en-GB",
"timezoneOffset": 0,
"precision": "day"
}Error codes
GET
Convert the provided value (e.g. ISO datetime) using the requested precision/format.
Path params
| tenant | Workspace ID in the path. Examples use demo-basic. |
| entity | date, time, datetime, timestamp, iso. |
| value | Input value to convert (e.g. ISO datetime). |
| format | Optional. Defaults to text. One of text, json, yaml, xml or js. |
Query params
| precision | One of year, month, day, hour, minute, second. |
| custom | Custom pattern (YYYY, MM, DD, HH, mm, ss). |
| tz | Integer UTC offset applied to the parsed value. Defaults to the edge timezone's current offset. |
| cache | off/none/false/0 to bypass edge cache. |
Request example
curl "https://getnow.date/api/demo-basic/get/datetime/2025-01-01T12:00:00.text?custom=YYYY-MM"Examples use demo-basic. Sign in to replace it with your workspace ID.
Response
{
"entity": "datetime",
"value": "2025-01",
"iso": "2025-01-01T12:00:00.000Z",
"unix": 1735732800,
"datetime": "2025-01-01 12:00:00",
"locale": "en-GB",
"timezoneOffset": 0,
"precision": "month"
}Error codes
GET
Return a fixed 640x200 SVG countdown for the target datetime. The endpoint is available on Unlimited and can count up after reaching zero.
Path params
| tenant | Workspace ID in the path. Examples use demo-basic. |
| preset | Timer preset. Use countdown for now. |
| format | SVG only. |
Query params
| target* | Required. ISO datetime or epoch (ms/s) to count toward. |
| label | Optional label above the timer (max 40 chars). |
| textColor | Hex or transparent. Default #ffffff. |
| bgColor | Hex or transparent. Default #111827. |
| fontSize | 18-160 px. Default 48. |
| countup | 1/true/yes/on to count up after the target. |
Request example
curl "https://getnow.date/api/demo-basic/timer/countdown.svg?target=2025-12-31T23:59:00"Examples use demo-basic. Sign in to replace it with your workspace ID.
Response
<svg width="640" height="200" viewBox="0 0 640 200">...countdown...</svg>
Error codes