API Docs
Build with Jubilq
Use test keys immediately. Live keys require admin approval before real buyers can checkout.
Authentication
Send your API key as a bearer token.
Authorization: Bearer jubilq_test_xxxxxxxxx
Events
GET /api/v1/events lists active public events. Use query params like state, town, category, q, limit, and ticketing_mode.
fetch('https://jubilq.com/api/v1/events?state=Lagos&ticketing_mode=jubilq', {
headers: { Authorization: 'Bearer jubilq_test_xxx' }
})Checkout Sessions
Create a hosted checkout link. Buyers sign in on Jubilq, pay through Flutterwave, and receive real Jubilq tickets.
POST /api/v1/checkout-sessions
{
"event_id": "event-uuid",
"tier_name": "Regular",
"quantity": 2,
"success_url": "https://yourapp.com/success",
"cancel_url": "https://yourapp.com/cancel",
"developer_fee_type": "percent",
"developer_fee_value": 5
}Webhooks
Jubilq queues signed webhooks for checkout and ticket events. Verify X-Jubilq-Signature using your webhook secret.
checkout.created ticket.order.paid ticket.generated checkout.failed