Timestamp (ISO 8601)

GET/v0/timestamp

Validates and parses values conforming to ISO 8601. Supports all major representations: date-time with timezone ( 2026-03-07T07:35:59Z), date only ( 2026-03-07), week dates ( 2026-W10-6), ordinal dates ( 2026-066), durations ( P3Y6M4DT12H30M5S), and intervals ( 2026-01-01/2026-12-31). Both extended (with separators) and basic (compact) formats are accepted.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	ISO 8601 string — datetime, date, week date, ordinal date, duration, or interval

Supported Formats

Type	Example	Description
datetime	2026-03-07T07:35:59Z	Date and time with optional timezone offset
date	2026-03-07	Calendar date (extended or basic format)
week	2026-W10-6	ISO week date with optional day of week
ordinal	2026-066	Year and day-of-year (1–365/366)
duration	P3Y6M4DT12H30M5S	Time duration with year/month/day/hour/minute/second components and totalSeconds
interval	2026-01-01/2026-12-31	Time interval (start/end, start/duration, or duration/end)

Example Requests

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/timestamp?value=2026-03-07T07:35:59Z"

Response — datetime

{
  "valid": true,
  "type": "datetime",
  "date": "2026-03-07",
  "time": "07:35:59",
  "utcOffset": "+00:00",
  "utc": "2026-03-07T07:35:59Z",
  "week": "2026-W10-6",
  "ordinal": "2026-066"
}

Response — duration

// P3Y6M4DT12H30M5S
{
  "valid": true,
  "type": "duration",
  "years": 3,
  "months": 6,
  "weeks": 0,
  "days": 4,
  "hours": 12,
  "minutes": 30,
  "seconds": 5,
  "totalSeconds": 111481805
}

Response — interval

// 2026-01-01/2026-12-31
{
  "valid": true,
  "type": "interval",
  "start": {
    "type": "date",
    "date": "2026-01-01",
    "week": "2026-W01-4",
    "ordinal": "2026-001"
  },
  "end": {
    "type": "date",
    "date": "2026-12-31",
    "week": "2026-W53-4",
    "ordinal": "2026-365"
  }
}

Response — invalid

{
  "valid": false
}