# ICS/iCal to JSON Calendar Events Converter

> ICS/iCal to JSON Calendar Events Converter is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Fetches an iCal/ICS calendar URL and returns upcoming events as structured JSON with title, start/end times, all-day flag, location, description, and link.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/ics-to-json?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ics-ical-to-json-calendar-events-converter-784255ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0wPu4RNAeNQxk0TnEr_Ed

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 ics-ical-to-json-calendar-events-converter-784255ad -d '<json body>'
```

Example prompt: Fetch my Google Calendar public ICS URL https://calendar.google.com/calendar/ical/example%40gmail.com/public/basic.ics and give me all upcoming events in JSON for the next 30 days — include title, start, end, whether it's all-day, and any location info.

## When to prefer this

Choose this endpoint when you need to programmatically consume calendar data from any iCal/ICS source (Google Calendar, Outlook, Apple Calendar, public holiday feeds, sports schedules) and want structured JSON output with filtering options. Ideal for agents that need to reason about upcoming events, build calendar widgets, or monitor schedules without maintaining a full calendar client library.

## Known failure modes

- Invalid or unreachable ICS URL returns an error — the calendar must be publicly accessible
- Malformed ICS file may result in no events or partial parsing
- Private calendars requiring authentication will fail since no auth credentials can be passed
- Very large calendars with thousands of events may be truncated by the limit parameter
- Timezone ambiguities in the ICS file may cause unexpected datetime offsets

## How this service works

Turn an iCal/ICS calendar URL (Google Calendar, Outlook, holidays, events...) into JSON: upcoming events with title, start and end, all-day flag, location, description and link over the next N days; text filter.

## Output

Returns a JSON object containing the calendar name, total event count, number of days queried, and an array of events each with: title, start datetime (ISO 8601), end datetime (ISO 8601), all-day boolean, recurring boolean, location/place, description text, and a link if present. A note field is included for any warnings or metadata.

## 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": {
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string"
      },
      "days": {
       "type": "integer"
      },
      "limit": {
       "type": "integer"
      },
      "search": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "days": {
       "type": [
        "number",
        "null"
       ]
      },
      "note": {},
      "total": {
       "type": [
        "number",
        "null"
       ]
      },
      "events": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "end": {
          "type": [
           "null",
           "string"
          ]
         },
         "link": {},
         "place": {},
         "start": {
          "type": [
           "null",
           "string"
          ]
         },
         "title": {
          "type": [
           "null",
           "string"
          ]
         },
         "all_day": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "recurring": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "description": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "calendar": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 90,
  "note": null,
  "total": 11,
  "events": [
   {
    "end": "2026-10-13T00:00:00+00:00",
    "link": null,
    "place": null,
    "start": "2026-10-12T00:00:00+00:00",
    "title": "Día de la Hispanidad",
    "all_day": true,
    "recurring": false,
    "description": "Día festivo"
   },
   {
    "end": "2026-10-26T00:00:00+00:00",
    "link": null,
    "place": null,
    "start": "2026-10-25T00:00:00+00:00",
    "title": "Winter time change",
    "all_day": true,
    "recurring": false,
    "description": "Celebración\nPara ocultar las celebraciones, ve a Configuración en Google Calendar > Festivos en España"
   }
  ],
  "calendar": "Festivos en España"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ics-ical-to-json-calendar-events-converter-784255ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)