SectionIntroduction
API V1.2
Updated 2 days ago

Build with IsabiEvents

Integrate Nigerian event ticketing into your own platforms. From automated ticket generation to custom checkout flows, our REST API handles the heavy lifting.

Introduction

The IsabiEvents API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

RESTful API

Standard JSON responses and predictable resource-oriented URLs for easy integration.

Secure Auth

Token-based authentication with granular permission scopes for every environment.

Authentication

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Developer Dashboard.

Authorization Header

Authorization: Bearer YOUR_SECRET_KEY

Authenticate with cURL

curl https://api.isabievents.ng/v1/events \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Errors

IsabiEvents uses conventional HTTP response codes to indicate the success or failure of an API request.

200
OK

Everything worked as expected.

400
Bad Request

The request was unacceptable.

401
Unauthorized

No valid API key provided.

Events

Search and retrieve event details across Nigeria. Use filters for city, category, and date ranges.

GET /v1/events

// List all trending events in Lagos
const response = await fetch('https://api.isabievents.ng/v1/events?city=lagos', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data.events);

Tickets

Manage ticket generation and verification. Generate unique QR codes for your custom checkout experiences.

POST /v1/tickets/generate

const ticket = await fetch('https://api.isabievents.ng/v1/tickets/generate', {
  method: 'POST',
  body: JSON.stringify({
    event_id: 'e1',
    attendee_email: 'tunde@example.com',
    tier: 'vip'
  })
});

Organizers

Retrieve public profiles and verification status for Nigerian event organizers.

Webhooks

IsabiEvents uses webhooks to notify your application when an event happens in your account.

Live Updates

Configure your webhook URL in the settings to start receiving real-time payloads.

Ready to get your API key?

Sign in to your developer dashboard to start building.