EKD Logo

Fest Connect

Connect. Celebrate. Create

DOC

API Endpoints

Below are all public endpoints available under /api/public/. Each requires valid x-client-id and x-client-secret headers.

GET/api/public/events

Fetch all events for the fest associated with your API key. Returns event details including registration fees, timing, venue, and rules.

Example (cURL)

curl -X GET "https://api.festconnect.com/api/public/events" \
  -H "x-client-id: <YOUR_CLIENT_ID>" \
  -H "x-client-secret: <YOUR_CLIENT_SECRET>"

Response

{
  "success": true,
  "festid": "a1b2c3d4-e5f6-g7h8-i9j0",
  "count": 5,
  "events": [
    {
      "id": "E123",
      "title": "Tech Quiz",
      "category": "Technical",
      "description": "Test your technical knowledge",
      "rules": "Individual participation only",
      "rulebook": "https://example.com/rulebook.pdf",
      "type": "solo",
      "max_team_size": 1,
      "start_time": "2025-03-21T10:00:00.000Z",
      "end_time": "2025-03-21T12:00:00.000Z",
      "venue": "Main Auditorium",
      "is_paid": true,
      "registration_fee": 100.00,
      "thumbnail": "https://example.com/thumbnail.jpg"
    }
  ]
}
GET/api/public/tickets

Retrieve all active tickets for the fest linked to your API key. Includes pricing, availability, accommodation options, and GST details.

Example (cURL)

curl -X GET "https://api.festconnect.com/api/public/tickets" \
  -H "x-client-id: <YOUR_CLIENT_ID>" \
  -H "x-client-secret: <YOUR_CLIENT_SECRET>"

Response

{
  "success": true,
  "festid": "a1b2c3d4-e5f6-g7h8-i9j0",
  "count": 3,
  "tickets": [
    {
      "id": "T001",
      "festId": "a1b2c3d4-e5f6-g7h8-i9j0",
      "editionId": "2025",
      "ticketName": "General Pass",
      "category": "standard",
      "totalQuantity": 1000,
      "totalSold": 250,
      "price": 299.00,
      "currency": "INR",
      "saleStart": "2025-01-01T00:00:00.000Z",
      "saleEnd": "2025-03-20T23:59:59.000Z",
      "hasAccommodation": true,
      "accommodationCharges": 200.00,
      "isActive": true,
      "isGSTApplicable": true,
      "gstPercentage": 18.0,
      "ticketDescription": "General access to all events"
    }
  ]
}
POST/api/public/prebook-ticket

Prebook a ticket before payment. Validates ticket availability, sale periods, and calculates the total payable amount including events, accommodation, GST, and platform fees.

Request Body

{
  "ticket_id": "1b2d3e4f-5g6h-7i8j-9k0l",
  "fest_id": "a1b2c3d4-e5f6-g7h8-i9j0",
  "event_stack": [
    {
      "event_id": "e1234567"
    }
  ]
}

Example (cURL)

curl -X POST "https://api.festconnect.com/api/public/prebook-ticket" \
  -H "Content-Type: application/json" \
  -H "x-client-id: <YOUR_CLIENT_ID>" \
  -H "x-client-secret: <YOUR_CLIENT_SECRET>" \
  -d '{
    "ticket_id": "1b2d3e4f-5g6h-7i8j-9k0l",
    "fest_id": "a1b2c3d4-e5f6-g7h8-i9j0",
    "event_stack": [{"event_id": "e1234567"}]
  }'

Response

{
  "success": true,
  "message": "Ticket pre-booked successfully",
  "data": {
    "pre_booking_id": "bbfa4423-81de-4713-98fa-28990ea4b785",
    "ticket_id": "1b2d3e4f-5g6h-7i8j-9k0l",
    "fest_id": "a1b2c3d4-e5f6-g7h8-i9j0",
    "has_accomodation": false,
    "event_stack_details": [
      {
        "event_id": "e1234567",
        "event_name": "Tech Quiz",
        "event_registration_fee": "100.00",
        "event_category": "Technical"
      }
    ],
    "prebooked_at": "2025-01-15T10:30:00.000Z",
    "ticket_currency": "INR",
    "ticket_has_gst": true,
    "ticket_gst_percentage": 18,
    "ticket_price": "299.00",
    "total_events_price": 100,
    "accomodation_charges": 0,
    "total_base_price": "399.00",
    "gst_on_total_price": "71.82",
    "platform_fee": "11.97",
    "gst_on_platform_fee": "2.15",
    "total_payable_amount": "484.94"
  }
}
POST/api/public/purchase-order

Complete the purchase for a prebooked ticket. Creates user account if needed, processes wallet payment, generates QR code, sets up check-in data, and sends confirmation email with ticket details.

Request Body

{
  "email": "user@example.com",
  "full_name": "Mahesh Aaryan",
  "phone": "9876543210",
  "college_name": "VIT University",
  "amount": 484.94,
  "ticket_id": "b22a44cc-1a34-49c3-9450-16e418b6a77b",
  "prebook_id": "bbfa4423-81de-4713-98fa-28990ea4b785"
}

Example (cURL)

curl -X POST "https://api.festconnect.com/api/public/purchase-order" \
  -H "Content-Type: application/json" \
  -H "x-client-id: <YOUR_CLIENT_ID>" \
  -H "x-client-secret: <YOUR_CLIENT_SECRET>" \
  -d '{
    "email": "user@example.com",
    "full_name": "Mahesh Aaryan",
    "phone": "9876543210",
    "college_name": "VIT University",
    "amount": 484.94,
    "ticket_id": "b22a44cc-1a34-49c3-9450-16e418b6a77b",
    "prebook_id": "bbfa4423-81de-4713-98fa-28990ea4b785"
  }'

Response

{
  "message": "Ticket purchased successfully",
  "payment": {
    "id": "pay_123456",
    "user_id": 12,
    "ticket_id": "b22a44cc-1a34-49c3-9450-16e418b6a77b",
    "user_ticket_id": "TCKT-12-2025-001",
    "participant_id": "PART-12-2025-001",
    "prebook_id": "bbfa4423-81de-4713-98fa-28990ea4b785",
    "amount": 484.94,
    "method": "wallet",
    "status": "success"
  },
  "qrCodeUrl": "https://bucket.s3.region.amazonaws.com/qrcodes/12-1730654324123.png"
}

On this page