# Natural Language Date Parser

> Natural Language Date Parser is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.0022/call, status unknown (last checked 2026-09-15).

Parses natural language date expressions ('today', 'tomorrow', '+3d', '-1w') and ISO/RFC date strings into structured datetime objects

## Facts

- Endpoint: GET https://api.x402node.dev/time/parse
- Price: $0.0022/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-e58b4835
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HAGMkctRsMIJeweerrCYO

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 api-x402node-dev-e58b4835
```

Example prompt: What structured datetime does '+3d' resolve to? Also parse 'yesterday' and '2024-06-15T10:00:00Z' into structured datetimes for me.

## When to prefer this

Use this endpoint when you need to resolve natural language or relative date expressions ('today', 'tomorrow', '+3d', '-1w') into structured, machine-readable datetimes. Prefer it over a timestamp converter when the input is a human-readable or relative expression rather than a raw epoch or known ISO string.

## Known failure modes

- Unrecognized date expression format returns a 4xx error with message about invalid input
- Ambiguous date strings without enough context may fail or return unexpected results
- Malformed ISO strings (e.g. month=13) trigger validation errors
- Payment not included or insufficient USDC returns 402 Payment Required

## How this service works

Natural language date parser, parse date string, flexible datetime parser, today tomorrow yesterday, relative date keywords, +3 days, -1 week, ISO date parser. Parse natural language ('today', 'tomorrow', '+3d', '-1w') or any ISO/RFC date string into structured datetime.

## Output

Returns a structured datetime object with the parsed absolute date and time, including fields such as ISO timestamp, Unix epoch, year, month, day, hour, minute, and timezone information derived from the input expression.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "text"
     ],
     "properties": {
      "text": {
       "type": "string",
       "description": "Input text (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-e58b4835/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)