Api documentation

BooomTickets API allows you to integrate ticket scanning and management into your applications.

🎤 Concerts

1. Create Event


POST /api/create-event
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "name": "Summer Fest 2025",
    "location": "Main Arena",
    "date": "2025-07-15T19:00:00Z"
}

2. List Events

Retrieve all created events


GET /api/events
Authorization: Bearer YOUR_API_TOKEN


[
    {
        "id": 12,
        "name": "Summer Fest 2025",
        "location": "Main Arena",
        "date": "2025-07-15T19:00:00Z"
    },
    {
        "id": 13,
        "name": "Rock Night",
        "location": "Stage B",
        "date": "2025-08-01T20:00:00Z"
    }
]

🎟 Tickets

1. Add Ticket

Add Ticket to an event


POST /api/add-ticket
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "barcode": "ABC123XYZ",
    "event_id": 12,
    "holder_name": "Иван Иванов"
}

2. Verify Ticket


POST /api/verify-ticket
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "event_id": 12,
    "barcode": "1234567890"
}

3. Ticket Status


GET /api/ticket-status/{barcode}
Authorization: Bearer YOUR_API_TOKEN

4. Ticket List

Get all tickets for a specific event with their statuses


GET /api/event/{event_id}/tickets
Authorization: Bearer YOUR_API_TOKEN


[
    {
        "barcode": "ABC123XYZ",
        "holder_name": "Иван Иванов",
        "status": "valid"
    },
    {
        "barcode": "XYZ987ABC",
        "holder_name": "Петр Петров",
        "status": "used"
    }
]

5. Check-in Log

documentation.checkin_log_desc


POST /api/checkin-log
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN

{
    "barcode": "1234567890",
    "device_id": "scanner01",
    "timestamp": "2025-05-28T19:00:00Z"
}

← documentation.back_to_docs