# Freeform Datetime String Parser

> Freeform Datetime String Parser is a paid API for AI agents from 1c09pdnrx1.execute-api.us-east-1.amazonaws.com, paid per call via x402, $0.001000/call, status unknown (last checked 2026-09-14).

Parses any freeform or ambiguous datetime string into a structured, normalized datetime representation

## Facts

- Endpoint: POST https://1c09pdnrx1.execute-api.us-east-1.amazonaws.com/v1/parse/datetime
- Price: $0.001000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/freeform-datetime-string-parser-121f19c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yjruaDelxTDsIudU5j_3d

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 freeform-datetime-string-parser-121f19c8 -d '<json body>'
```

Example prompt: Can you parse this datetime string for me — 'next Friday at half past 3 in the afternoon EST' — and give me a structured, normalized form with the date, time, and timezone broken out?

## When to prefer this

Use this endpoint when you need to reliably normalize arbitrary or user-supplied datetime strings into a structured form — especially when input format is inconsistent, informal, or natural language. Ideal for preprocessing user inputs, log timestamps, or form fields before downstream date arithmetic or storage. Prefer this over regex-based parsing when the input is unpredictable.

## Known failure modes

- Completely unparseable input string returns error or null result
- Ambiguous strings with no context (e.g. '3/4') may yield uncertain or locale-dependent results
- Relative expressions (e.g. 'yesterday') may require a reference date that wasn't provided
- Strings mixing multiple incompatible formats may fail to parse
- Payment failure (402) if USDC balance is insufficient

## How this service works

Parse any freeform datetime string into a structured normalized form — $0.001 USDC

## Output

A structured object containing the normalized datetime, including ISO 8601 timestamp, individual date components (year, month, day), time components (hour, minute, second), timezone, and confidence or ambiguity flags if the input was unclear.

## Example request

```json
{
 "input": "2024-03-15T15:30:00Z"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "DatetimeParseRequest",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "string",
   "title": "Input",
   "maxLength": 500,
   "minLength": 1,
   "description": "Freeform datetime string in any format."
  },
  "timezone": {
   "type": "string",
   "title": "Timezone",
   "default": "UTC",
   "description": "IANA tz name (e.g. 'America/New_York')."
  },
  "base_time": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Base Time",
   "description": "ISO 8601 reference; defaults to now UTC."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "iso",
  "unix",
  "timezone",
  "components",
  "confidence",
  "parsed_input",
  "relative_human",
  "relative_seconds"
 ],
 "properties": {
  "iso": {
   "type": "string"
  },
  "unix": {
   "type": "number"
  },
  "timezone": {
   "type": "string"
  },
  "components": {
   "type": "object",
   "required": [
    "day",
    "hour",
    "year",
    "month",
    "minute",
    "second",
    "weekday",
    "day_name"
   ],
   "properties": {
    "day": {
     "type": "number"
    },
    "hour": {
     "type": "number"
    },
    "year": {
     "type": "number"
    },
    "month": {
     "type": "number"
    },
    "minute": {
     "type": "number"
    },
    "second": {
     "type": "number"
    },
    "weekday": {
     "type": "number"
    },
    "day_name": {
     "type": "string"
    }
   }
  },
  "confidence": {
   "type": "string"
  },
  "parsed_input": {
   "type": "string"
  },
  "relative_human": {
   "type": "string"
  },
  "relative_seconds": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/freeform-datetime-string-parser-121f19c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 1c09pdnrx1.execute-api.us-east-1.amazonaws.com](https://www.zero.xyz/host/1c09pdnrx1.execute-api.us-east-1.amazonaws.com/llms.txt)