# Party & Event Planner - Event Timeline Calculator

> Party & Event Planner - Event Timeline Calculator is a paid API for AI agents from party-event-calc.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Converts an event start time and milestone offsets (in minutes before start) into a chronological 12-hour clock schedule, listed earliest first.

## Facts

- Endpoint: GET https://party-event-calc.x402tookit.com/event-timeline?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/party-event-planner-event-timeline-calculator-ea80a833
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-8axAzx8nZOBmcTNYlbef

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 party-event-planner-event-timeline-calculator-ea80a833
```

Example prompt: Can you build me a backwards event timeline for a party starting at 7:00 PM, with milestones for Venue access at 240 minutes before, Decor done at 120 minutes before, Caterer arrives at 90 minutes before, Sound check at 60 minutes before, and Doors open at 30 minutes before?

## When to prefer this

Use this endpoint when you need to convert an event start time and a set of pre-event milestones (expressed as minutes before start) into human-readable 12-hour clock times in chronological order. It is purpose-built for party and event planning logistics, returning a structured, labeled timeline rather than a raw time difference. Choose this over a generic calendar API when you need a ready-to-display run-of-show schedule with vendor/activity labels.

## Known failure modes

- Missing or unparseable eventStart parameter returns an error
- Malformed milestones string (bad format) may cause parsing failure or default fallback
- Times that cross midnight may produce unexpected day offset values
- Invalid time formats (e.g. ambiguous strings) may not be recognized

## How this service works

Backwards timeline from the event start: milestones given as minutes before start become 12-hour clock times, earliest first.

## Output

Returns an ordered array of timeline steps, each with a label, 12-hour clock time, step number, minutes before event start, and an optional day offset. Also includes the event start time in clock format, total milestone count, and hours spanning from the first milestone to the start time.

## 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": [
      "eventStart"
     ],
     "properties": {
      "eventStart": {
       "type": "string",
       "description": "When the event starts, like 6:00 PM or 18:00"
      },
      "milestones": {
       "type": "string",
       "description": "Comma list of label:minutesBefore (default Venue access:240,Decor done:120,Caterer arrives:90,Sound check:60,Doors open:30)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "timeline": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "step": {
          "type": [
           "null",
           "number"
          ]
         },
         "time": {
          "type": [
           "null",
           "string"
          ]
         },
         "label": {
          "type": [
           "null",
           "string"
          ]
         },
         "dayOffset": {
          "type": [
           "null",
           "number"
          ]
         },
         "minutesBefore": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/party-event-planner-event-timeline-calculator-ea80a833/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from party-event-calc.x402tookit.com](https://www.zero.xyz/host/party-event-calc.x402tookit.com/llms.txt)