# Zentix Agent Integration Guide

Zentix provides public AI-safe endpoints for browsing ticket availability.
All endpoints return plain text. No authentication, no POST requests, no JSON.

## API Base URL
https://zentix.com/agent

---

## IMPORTANT RULES

1. Do not scrape the consumer webpage — use these endpoints.
2. All endpoints are GET requests returning plain text.
3. Follow the flow in order. Each response tells you the next step.
4. The sessions endpoint includes ready-to-use checkout links — just give one to the user.
5. Inventory is NOT held until the user clicks the checkout link.

---

## PURCHASE FLOW

### Step 1: List Events
GET https://zentix.com/agent/events.txt

### Step 2: Available Dates
GET https://zentix.com/agent/events/{eventId}/dates.txt

### Step 3: Ticket Types for a Date
GET https://zentix.com/agent/events/{eventId}/ticket-types.txt?date=YYYY-MM-DD

### Step 4: Time Slots with Checkout Links
GET https://zentix.com/agent/events/{eventId}/sessions.txt?date=YYYY-MM-DD

This is the final step. The response includes pre-built checkout links
for each ticket type at each time slot (Buy 1, Buy 2, Buy 4).
Give the appropriate link to the user. When they click it, a cart is
created and they proceed to payment.

For a custom quantity, change the number after the colon in the URL.
Example: types=TICKET_TYPE_ID:3 means 3 tickets.

---

## EXAMPLE

User: "Get me 2 General Admission tickets for Saturday at 8pm"

1. Fetch /agent/events/{eventId}/dates.txt → find Saturday's date
2. Fetch /agent/events/{eventId}/ticket-types.txt?date=2027-02-13 → confirm General Admission exists
3. Fetch /agent/events/{eventId}/sessions.txt?date=2027-02-13 → find the 08:00 PM session
4. In that session, find General Admission, take the "Buy 2" link
5. Give that link to the user

---

## NOTES
- No authentication required
- Rate limited to 60 requests/minute
- Never exposes exact capacity — only available / limited / sold_out
- Inventory is NOT held until the user clicks the checkout link