EKD Logo

Fest Connect

Connect. Celebrate. Create

DOC

API Examples

Explore ready-to-use API examples for Fest Connect’s public endpoints. Use these cURL commands to test integration with your API keys.

Fetch All Events

Retrieve all public events for your fest with complete details including registration fees, rules, timing, and venue information.

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": 3,
  "events": [
    {
      "id": "E001",
      "title": "Tech Quiz",
      "category": "Technical",
      "description": "Test your technical knowledge across various domains",
      "rules": "Individual participation, no external help allowed",
      "rulebook": "https://bucket.s3.region.amazonaws.com/rulebooks/tech-quiz.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://bucket.s3.region.amazonaws.com/thumbnails/tech-quiz.jpg"
    },
    {
      "id": "E002",
      "title": "Group Dance",
      "category": "Cultural",
      "description": "Showcase your dancing skills in a team",
      "rules": "Team size: 5-15 members, time limit: 8 minutes",
      "type": "team",
      "max_team_size": 15,
      "start_time": "2025-03-22T14:00:00.000Z",
      "end_time": "2025-03-22T17:00:00.000Z",
      "venue": "Open Air Theater",
      "is_paid": false,
      "registration_fee": 0.00,
      "thumbnail": null
    }
  ]
}

Fetch All Tickets

Get all active fest tickets with complete pricing, accommodation options, GST details, and availability information.

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": 2,
  "tickets": [
    {
      "id": "T001",
      "festId": "a1b2c3d4-e5f6-g7h8-i9j0",
      "editionId": "2025",
      "ticketName": "General Pass",
      "category": "standard",
      "totalQuantity": 1000,
      "totalSold": 347,
      "price": 299.00,
      "currency": "INR",
      "saleStart": "2025-01-01T00:00:00.000Z",
      "saleEnd": "2025-03-20T23:59:59.000Z",
      "hasAccommodation": false,
      "accommodationCharges": 0.00,
      "isActive": true,
      "isGSTApplicable": true,
      "gstPercentage": 18.0,
      "ticketDescription": "General access to all fest events and activities"
    },
    {
      "id": "T002",
      "festId": "a1b2c3d4-e5f6-g7h8-i9j0",
      "editionId": "2025",
      "ticketName": "VIP Pass with Accommodation",
      "category": "premium",
      "totalQuantity": 200,
      "totalSold": 89,
      "price": 799.00,
      "currency": "INR",
      "saleStart": "2025-01-01T00:00:00.000Z",
      "saleEnd": "2025-03-15T23:59:59.000Z",
      "hasAccommodation": true,
      "accommodationCharges": 300.00,
      "isActive": true,
      "isGSTApplicable": true,
      "gstPercentage": 18.0,
      "ticketDescription": "VIP access with accommodation for 3 days"
    }
  ]
}

Prebook a Ticket

Reserve a ticket with event selections before payment. Returns detailed pricing breakdown including GST, platform fees, and total payable amount.

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": "T001",
    "fest_id": "a1b2c3d4-e5f6-g7h8-i9j0",
    "event_stack": [
      {"event_id": "E001"},
      {"event_id": "E003"}
    ]
  }'

Response

{
  "success": true,
  "message": "Ticket pre-booked successfully",
  "data": {
    "pre_booking_id": "bbfa4423-81de-4713-98fa-28990ea4b785",
    "ticket_id": "T001",
    "fest_id": "a1b2c3d4-e5f6-g7h8-i9j0",
    "has_accomodation": false,
    "event_stack_details": [
      {
        "event_id": "E001",
        "event_name": "Tech Quiz",
        "event_registration_fee": "100.00",
        "event_category": "Technical"
      },
      {
        "event_id": "E003",
        "event_name": "Startup Pitch",
        "event_registration_fee": "200.00",
        "event_category": "Business"
      }
    ],
    "prebooked_at": "2025-01-15T14:30:45.123Z",
    "ticket_currency": "INR",
    "ticket_has_gst": true,
    "ticket_gst_percentage": 18,
    "ticket_price": "299.00",
    "total_events_price": 300,
    "accomodation_charges": 0,
    "total_base_price": "599.00",
    "gst_on_total_price": "107.82",
    "platform_fee": "17.97",
    "gst_on_platform_fee": "3.23",
    "total_payable_amount": "728.02"
  }
}

Complete Purchase Order

Finalize the pre-booked ticket purchase. Creates user account if needed, processes payment, generates QR code, and sends confirmation email.

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": "mahesh.aaryan@example.com",
    "full_name": "Mahesh Aaryan",
    "phone": "9876543210",
    "college_name": "VIT University",
    "amount": 728.02,
    "ticket_id": "T001",
    "prebook_id": "bbfa4423-81de-4713-98fa-28990ea4b785"
  }'

Response

{
  "message": "Ticket purchased successfully",
  "payment": {
    "id": "pay_abc123def456",
    "user_id": 123,
    "ticket_id": "T001",
    "user_ticket_id": "TCKT-123-2025-001",
    "participant_id": "PART-123-2025-001",
    "prebook_id": "bbfa4423-81de-4713-98fa-28990ea4b785",
    "amount": 728.02,
    "method": "wallet",
    "status": "success",
    "created_at": "2025-01-15T14:35:20.456Z"
  },
  "qrCodeUrl": "https://bucket.s3.region.amazonaws.com/qrcodes/123-1730654324123.png"
}

On this page