rigitiX Developer Platform

Developer API & Widget SDK Documentation

Complete technical reference for integrating rigitiX ticketing widgets, querying events, checking venue availability, and automating partner integrations.

Quickstart Overview

The rigitiX REST API conforms to standard HTTP verbs and returns JSON responses. The base URL for all v1 endpoints is:

https://rigitix.com/api/v1

Authentication

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:

Authorization: Bearer vp_sec_...
-- or --
X-API-Key: vp_sec_...

Generate your secret API key from the Developer API Keys console.

In-App Partner Integration

Partner Ticketing API (VistaPay)

Launch Live Sandbox

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.

Endpoints
POST https://rigitix.com/api/v1/tickets/issue (Generic / Postman / Custom Websites)
POST https://rigitix.com/api/v1/partners/vistapay/issue-ticket (VistaPay In-App Dedicated)
Exclusive Partnership Policy Restricted to Single Organizer (Next 5 Editions) • 250 Tickets Max

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.

  • Organizer Guard: Requests for events outside the authorized organizer's portfolio are rejected with 422 Unprocessable.
  • Edition Cap: Bookings are strictly restricted across at most 5 distinct event editions.
  • 250-Ticket Hard Quota: Concurrency locks prevent overselling past the agreed 250 tickets limit. Realtime remaining allocation is returned in the API response.

Security & Authentication Headers

You can authenticate using direct API keys or enterprise HMAC-SHA256 signatures:

Content-Type: application/json
X-Partner-Id: vistapay
X-Partner-Key: <your_public_api_key>
X-Timestamp: <unix_epoch_timestamp_in_seconds> (e.g. 1794787881)
X-Signature: <hex_hmac_sha256_hash>
-- or direct secret token auth (Postman / Custom Website) --
Authorization: Bearer <your_secret_key>
HMAC Calculation Formula: hash_hmac('sha256', timestamp + '.' + raw_json_body, secret_key)

Sample Request Payload

{
  "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
  }
}

Sample Response (200 OK)

{
  "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"
    }
  }
}

Canonical Group Link (Orders Hub)

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.

POST

/api/v1/vouchers/redeem

Redeems a Future Edition Voucher for an official admission ticket once the organizer publishes that edition on rigitiX.

Request Body

{
  "voucher_code": "RGX-VCH-491028",
  "security_pin": "304918"
}
Before Organizer Publishes:

Returns pending_launch confirming the voucher is active and safely registered.

Once Organizer Publishes:

Generates official admission ticket with QR code, marks voucher redeemed, and allows gate check-in.

Ticketing Widget SDK

No Code Required

Embed high-converting checkout directly into any website (WordPress, Webflow, Squarespace, Shopify, or custom HTML).

Mode 1: 1-Line Popup Modal

Opens a distraction-free checkout overlay above your website with bank transfer, card, and crypto support.

<script src="https://rigitix.com/embed/widget.js" async></script> <button class="rigitix-btn-styled" data-rigitix-event="YOUR_EVENT_SLUG"> Buy Tickets </button>

Mode 2: Responsive Inline Ticket Box

Embeds a seamless ticket tier selector and cart directly on your page layout with automatic height auto-resizing.

<div id="rigitix-widget" data-rigitix-event="YOUR_EVENT_SLUG" data-rigitix-mode="inline"></div> <script src="https://rigitix.com/embed/widget.js" async></script>
GET

/api/v1/events

Retrieve a paginated catalog of active public events. Filter by city or target month.

Query Parameters

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).
curl -X GET "https://rigitix.com/api/v1/events?city=Lagos" -H "Accept: application/json"
GET

/api/v1/venues/{slug}

Check availability, confirmed booking dates, capacity limits, and amenity specifications for a specific registered venue.

curl -X GET "https://rigitix.com/api/v1/venues/aztech-arcum" -H "Accept: application/json"
GET

/api/v1/calendar/feed

Returns real-time event calendar feed formatted for calendar views and sync applications.

curl -X GET "https://rigitix.com/api/v1/calendar/feed" -H "Accept: application/json"
GET

/api/v1/user/profile

Returns the authenticated user's profile, active multi-role persona, creator verification, and wallet earnings.

curl -X GET "https://rigitix.com/api/v1/user/profile" \ -H "Accept: application/json" \ -H "Authorization: Bearer rx_live_..."

Rate Limits & Error Handling

Growth Tier
60 req/min
Enterprise Tier
300 req/min

When limits are exceeded, the API returns HTTP 429 Too Many Requests with a Retry-After header in seconds.

People are going

Notifications

Stay in the vibe

Loading Vibe...

All caught up!

Discover your next vibe and start earning RXP

Browse Events