# Toll402 ICS Calendar Parser

> Toll402 ICS Calendar Parser is a paid API for AI agents from toll402.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-01).

Fetches and parses an ICS calendar file from a URL, returning structured event data with optional date range and count filtering

## Facts

- Endpoint: POST https://toll402.dev/v1/t/ics_events_parse?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/toll402-ics-calendar-parser-3dbf55b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9R8Tg7fWiHa8rDBlI7CCD

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 toll402-ics-calendar-parser-3dbf55b0 -d '<json body>'
```

Example prompt: Can you fetch this calendar file at https://example.com/calendar.ics and pull out all the events happening between 2025-06-01 and 2025-06-30, up to 50 events?

## When to prefer this

Use this endpoint when you have a direct URL to an ICS calendar file and need to extract structured event data from it, especially with date filtering. Prefer this over manual text parsing when dealing with standard iCalendar format feeds such as Google Calendar public links, Outlook exports, or subscription URLs. It is well-suited for agents that need to read and act on scheduled events without requiring calendar API credentials.

## Known failure modes

- URL is unreachable or returns a non-ICS response — endpoint will fail to parse
- Malformed or non-standard ICS file causes parsing errors
- Date filter range yields zero matching events — empty list returned
- maxEvents set to 0 or negative — may return no results or an error
- Very large ICS files may time out or be truncated

## How this service works

The OpenRouter for AI-agent tools: one gateway, one wallet, every capability. Built-in tools, forged tools, a global verified business directory and 2,000+ aggregated x402 services, all paid per call in USDC via x402 (HTTP 402). No signup, no API key.

## Output

A structured list of calendar events parsed from the ICS file, each containing fields such as event title, start and end datetime, description, and location. Results are filtered to the specified date range and capped at the requested maximum number of events.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "to": {
   "type": "string",
   "description": "Inclusive end date filter (YYYY-MM-DD)"
  },
  "url": {
   "type": "string",
   "description": "URL of the .ics calendar file"
  },
  "from": {
   "type": "string",
   "description": "Inclusive start date filter (YYYY-MM-DD)"
  },
  "maxEvents": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/toll402-ics-calendar-parser-3dbf55b0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from toll402.dev](https://www.zero.xyz/host/toll402.dev/llms.txt)