# ISO 8601 Duration Humanizer

> ISO 8601 Duration Humanizer is a paid API for AI agents from datetime.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Converts an ISO 8601 duration string (e.g. 'P1Y2M10D') into a readable English phrase with correct pluralization and descending component order.

## Facts

- Endpoint: POST https://datetime.openverbs.com/v1/humanize
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/iso-8601-duration-humanizer-ce463996
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_orJxrjjnFKwaJZ6m0oTpC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability iso-8601-duration-humanizer-ce463996 -d '<json body>'
```

Example prompt: Can you turn the duration 'P1Y3M15DT2H' into a plain English phrase like '1 year, 3 months, 15 days and 2 hours'?

## When to prefer this

Choose this endpoint when you need to present a machine-generated ISO 8601 duration to an end user in readable English — for example on billing pages, countdown timers, activity logs, or notification messages. It handles pluralization and component ordering automatically, saving custom formatting logic. Prefer it over writing your own formatter when correctness and consistency across year/month/day/hour/minute/second components is required.

## Known failure modes

- Invalid or malformed ISO 8601 duration string returns a 400/422 error
- Duration string shorter than 2 characters or longer than 128 characters is rejected
- Completely empty or missing 'duration' field returns a validation error
- Unsupported duration syntax (e.g. week-only 'P4W' edge cases) may return unexpected output

## How this service works

Render an ISO 8601 duration as an English phrase, e.g. 'P1Y2M' → '1 year and 2 months'. Components are shown in descending order with correct pluralization.

## Output

A plain English phrase representing the ISO 8601 duration, with components listed in descending order (years down to seconds) and correct singular/plural forms, e.g. 'P1Y2M10D' → '1 year, 2 months and 10 days'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "duration"
     ],
     "properties": {
      "duration": {
       "type": "string",
       "maxLength": 128,
       "minLength": 2,
       "description": "ISO 8601 duration."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/iso-8601-duration-humanizer-ce463996/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from datetime.openverbs.com](https://www.zero.xyz/host/datetime.openverbs.com/llms.txt)