Build with Jubilq

Authentication

Send your API key as a bearer token.

Authorization: Bearer jubilq_test_xxxxxxxxx

Event Auto-Publishing API

Automatically publish events from your platform directly to Jubilq using your API key (events:write scope). Pass your original event post URL as external_link and your direct poster image URL as image_url.Zero Storage Copy: Poster images are displayed using your direct URL without copying into Jubilq storage.

POST /api/v1/events
Authorization: Bearer jubilq_live_xxxxxxxxxxxx

{
  "title": "Lagos Tech & Nightlife Festival 2026",
  "description": "The ultimate tech, music, and networking experience.",
  "external_link": "https://yourapp.com/events/lagos-tech-fest",
  "image_url": "https://yourapp.com/cdn/posters/poster.jpg",
  "state": "Lagos",
  "town": "Victoria Island",
  "address": "Eko Hotel & Suites, Victoria Island",
  "category": "Tech",
  "start_time": "2026-11-20T18:00:00Z",
  "end_time": "2026-11-20T23:30:00Z",
  "ticket_tiers": [
    { "name": "Standard Pass", "price": 5000 },
    { "name": "VIP Access", "price": 25000 }
  ]
}

Querying Events

GET /api/v1/events lists active public events on Jubilq. Use filters like state, town, category, q, limit, and ticketing_mode.

fetch('https://jubilq.com/api/v1/events?state=Lagos&ticketing_mode=external', {
  headers: { Authorization: 'Bearer jubilq_live_xxxxxxxxx' }
})

Checkout Sessions

Create a hosted checkout link (POST /api/v1/checkout-sessions) to sell tickets for Jubilq events with custom fee splits.

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
}

Orders API

Query order status and verify ticket issuance using GET /api/v1/orders?order_id=uuid.

fetch('https://jubilq.com/api/v1/orders?order_id=123e4567-e89b-12d3-a456-426614174000', {
  headers: { Authorization: 'Bearer jubilq_live_xxxxxxxxx' }
})

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

Rate Limits & Security

Test API keys are limited to 120 requests/minute. Approved Live API keys support up to 600 requests/minute. All API responses include strict CORS headers and security protection.