{"schemaVersion":"1.0","name":"WingZen Charter Marketplace","description":"WingZen is a private aviation technology platform connecting charter operators with customers across North America. Customers search for available aircraft by route, date, and passenger count and receive firm all-inclusive pricing immediately. Payment is an authorization hold — not charged until the operator confirms. WingZen is a facilitator, not a carrier or principal.","url":"https://www.wingzen.com","apiBase":"https://www.wingzen.com/api","version":"0.1.0","capabilities":[{"name":"charter_search","description":"Search for available private charter aircraft by departure airport, destination airport, date, time, and passenger count. Returns firm all-inclusive pricing, aircraft details, flight time, and fuel stop information.","endpoint":"/api/search/aircraft","method":"GET","requires_auth":false,"input_schema":{"departure":"Airport database ID (integer) — use airport autocomplete to resolve city names to IDs","destination":"Airport database ID (integer)","date":"YYYY-MM-DD","time":"HH:MM (24-hour, 30-minute increments)","passengers":"Integer 1-20"},"output_schema":"Array of aircraft results with totalFlightCost (USD dollars), flightTime, passengerCapacity, fuelStopsRequired, operatorName","status":"production"},{"name":"charter_booking","description":"Create a charter flight booking with payment authorization. Card is held but not charged until operator confirms. Operator has up to 12 hours to respond.","endpoint":"/api/v1/charter/draft + /api/v1/charter/confirm","method":"POST","requires_auth":true,"auth_type":"oauth2_client_credentials","status":"planned","available_from":"Phase B"},{"name":"charter_status","description":"Poll booking status and receive current state, proposed times (TIME_NEGOTIATION), and logistics fields (CONFIRMED).","endpoint":"/api/v1/charter/status/{id}","method":"GET","requires_auth":true,"auth_type":"oauth2_client_credentials","status":"planned","available_from":"Phase B"},{"name":"charter_webhook","description":"Register a callback URL to receive push notifications on booking state transitions (CONFIRMED, DECLINED, TIME_PROPOSED, CANCELLED). Replaces polling for long-lived agent sessions.","requires_auth":true,"auth_type":"oauth2_client_credentials","status":"planned","available_from":"Phase C"}],"authentication":{"current":"Session-based (browser) — human-initiated bookings","programmatic":{"type":"oauth2_client_credentials","token_url":"/api/v1/auth/token","docs_url":"/api/llms-full.txt","status":"planned","available_from":"Phase B","note":"API client credentials are not yet issued. Agents should use the existing browser-based search endpoint (/api/search/aircraft) without authentication for search-only use cases."}},"guardrails":["All bookings require human authorization before payment capture — payment hold is placed at checkout, captured only on operator confirmation","Operator confirmation is required — bookings are never instant; operators have up to 12 hours to respond","Budget limits will be enforced per API client (Phase B) — agents cannot spend above configured caps","PII (passenger contact details, government IDs, logistics) is restricted to confirmed bookings only","WingZen is a facilitator — the contractual charter is directly between the customer and the aircraft operator","Route and date changes require a new booking — in-flight modification requests go through the operator"],"legal_position":"WingZen is a technology platform facilitating connections between charter operators and customers. WingZen does not operate aircraft and is not a carrier, broker, or principal. All charters are contracted directly between the customer and the aircraft operator.","booking_state_machine":{"states":["PENDING_HUMAN_APPROVAL","PENDING_SPLIT_PAYMENT","REQUESTED","TIME_NEGOTIATION","CONFIRMED","COMPLETED","CANCELLED"],"initial_agent_state":"REQUESTED","initial_human_approval_state":"PENDING_HUMAN_APPROVAL","terminal_states":["COMPLETED","CANCELLED"],"confirmation_state":"CONFIRMED","notes":"Agents polling /api/v1/charter/status should treat CONFIRMED as the success terminal for travel fulfillment purposes. COMPLETED is the post-flight terminal. TIME_NEGOTIATION requires human or agent response within 24 hours. PENDING_HUMAN_APPROVAL is an agentic-only pre-state: the booking has been created but a human principal must approve before it advances to REQUESTED. Operators do not see bookings in this state."},"rate_limits":{"search":"Browser sessions: standard Vercel edge limits. Programmatic API (Phase B): per-client budget TBD.","booking":"Programmatic booking API not yet available."},"contact":{"support":"https://www.wingzen.com/contact","website":"https://www.wingzen.com"},"discovery":{"llms_txt":"https://www.wingzen.com/api/llms.txt","llms_full_txt":"https://www.wingzen.com/api/llms-full.txt","openapi":"https://www.wingzen.com/.well-known/openapi.json","sitemap":"https://www.wingzen.com/api/sitemap.xml"}}