Complete technical reference for integrating rigitiX ticketing widgets, querying events, checking venue availability, and automating partner integrations.
The rigitiX REST API conforms to standard HTTP verbs and returns JSON responses. The base URL for all v1 endpoints is:
Public endpoints (such as event discovery and calendar feeds) do not require authentication. For secure ticket issuance and partner calls, authentication is supported via either Bearer token or X-API-Key header:
Generate your secret API key from the Developer API Keys console.
Allows third-party consumer and wallet applications (like VistaPay) to sell event passes directly inside their mobile app. Upon payment confirmation, the partner app calls rigitiX to validate the transaction, atomically lock and decrement event ticket inventory, generate anti-counterfeit QR codes, issue bulk perk vouchers, and assign multi-edition entitlements.
This specific in-app integration is strictly bound to the authorized organizer's event series (e.g. Vibes Barn across their next 5 editions). VistaPay holds an exclusive allocation for 250 tickets total to be purchased natively through their mobile app.
Note: This 250-ticket limit is specific to the VistaPay in-app contract. General organizers and developers integrating via rigitiX Universal APIs or Widgets are not subject to this quota.
422 Unprocessable.You can authenticate using direct API keys or enterprise HMAC-SHA256 signatures:
hash_hmac('sha256', timestamp + '.' + raw_json_body, secret_key)
{
"event_slug": "leadership-clinic",
"ticket_tier": "Executive Access",
"quantity": 2,
"customer": {
"name": "Jane Doe",
"email": "jane.doe@company.com",
"phone": "+2348012345678",
"organization": "Acme Holdings"
},
"payment": {
"reference": "VP-LC5-202611-9842",
"amount": 10000,
"currency": "NGN",
"channel": "vistapay_wallet",
"paid_at": "2026-11-14T20:30:00Z"
},
"partnership_entitlements": {
"bulk_package": "Executive Duo",
"vouchers": [
"Executive Lounge Pass",
"Printed Masterclass Workbook"
],
"editions_access": [
"Leadership Clinic 6.0 (Live)",
"Leadership Clinic 7.0 (Coming Edition)"
],
"cashback_verified": true
}
}
{
"status": "success",
"message": "Tickets and vouchers issued successfully",
"data": {
"booking_reference": "RGX-BK-78491",
"quantity": 2,
"tickets": [
{
"ticket_code": "T11-1vbwzokw26",
"voucher_code": "leadership-clinic11-gxr5xda26",
"qr_code_url": "https://rigitix.com/tickets/qr/T11-1vbwzokw26.png",
"view_url": "https://rigitix.com/tickets/view/T11-1vbwzokw26"
}
],
"vouchers": [
{
"title": "Executive Lounge Pass",
"voucher_code": "RGX-VCH-829140",
"security_pin": "581920",
"status": "active"
},
{
"title": "Coming Edition Pass: Leadership Clinic 7.0",
"voucher_code": "RGX-VCH-491028",
"security_pin": "304918",
"status": "active"
}
],
"group_link": "https://rigitix.com/orders/RGX-BK-78491",
"editions_covered": [
"Leadership Clinic 6.0 (Live)",
"Leadership Clinic 7.0 (Coming Edition)"
],
"partnership_quota": {
"total_allocated": 250,
"total_sold": 2,
"remaining": 248,
"max_editions": 5,
"editions_used": 1,
"authorized_organizer": "Vibes Barn"
}
}
}
The group_link (e.g. /orders/{reference}) displays the complete attendee order. Buyers can distribute individual passes to team members or guests via WhatsApp/email, and attendees can view their passes, download live QR codes, and view their benefit vouchers with security PINs.
Redeems a Future Edition Voucher for an official admission ticket once the organizer publishes that edition on rigitiX.
{
"voucher_code": "RGX-VCH-491028",
"security_pin": "304918"
}
Returns pending_launch confirming the voucher is active and safely registered.
Generates official admission ticket with QR code, marks voucher redeemed, and allows gate check-in.
Embed high-converting checkout directly into any website (WordPress, Webflow, Squarespace, Shopify, or custom HTML).
Opens a distraction-free checkout overlay above your website with bank transfer, card, and crypto support.
Embeds a seamless ticket tier selector and cart directly on your page layout with automatic height auto-resizing.
Retrieve a paginated catalog of active public events. Filter by city or target month.
| Parameter | Type | Description |
|---|---|---|
| city | string (optional) | Filter events by city name (e.g. Lagos, Uyo, Abuja). Default: all. |
| month | string (optional) | Filter events by month in YYYY-MM format (e.g. 2026-10). |
Check availability, confirmed booking dates, capacity limits, and amenity specifications for a specific registered venue.
Returns real-time event calendar feed formatted for calendar views and sync applications.
Returns the authenticated user's profile, active multi-role persona, creator verification, and wallet earnings.
When limits are exceeded, the API returns HTTP 429 Too Many Requests with a Retry-After header in seconds.
People are going
Smart RXP Boost Active!
Confirmed attendees get +20 RXP. Only spots left for bonus.
Discovery Powered by rigitiX Smart Social ™
Stay in the vibe