API Documentation

Authentication

Every request must include your operator API key in the x-api-key header. Find it in your dashboard.

x-api-key: <your_operator_api_key>

POST /api/v1/flights

Create or update a flight listing. Rejected automatically if price > $5,000 or departure > 7 days out.

curl -X POST https://lpjflights.app/api/v1/flights \
  -H "x-api-key: $KAMIDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "flight_number": "KMY-2201",
    "departure_city": "Teterboro",
    "departure_state": "NJ",
    "departure_icao": "KTEB",
    "arrival_city": "West Palm Beach",
    "arrival_icao": "KPBI",
    "date_time": "2026-06-22T14:30:00Z",
    "aircraft_type": "Citation CJ3",
    "seats_available": 6,
    "is_entire_plane": true,
    "price": 4250
  }'

POST /api/webhooks/inventory

Real-time updates. Send { event: "delete", flight_id: "..." } to remove a listing.

curl -X POST https://lpjflights.app/api/webhooks/inventory \
  -H "x-api-key: $KAMIDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "event": "delete", "flight_id": "uuid-here" }'

Rate Limits & Validation

• · 100 requests per minute per operator.
• · Price must be greater than $0 and at most $5,000 USD.
• · Departure must be in the future and within the next 7 days.
• · Expired flights are auto-purged hourly.