REST API

Powerful REST API

Build custom booking experiences with our comprehensive API. Every feature available in the dashboard is accessible via our REST API.

Base URL:https://api.aionbooking.com
Full Documentation Get API Key
18+
Endpoints
100 req/min
Free tier
1,000 req/min
Paid tier
99.9%
Uptime SLA

Authentication

AionBooking uses JWT Bearer tokens for authentication. Every request to the API must include your token in the Authorization header. Tokens are issued on sign-in and expire after 24 hours. Refresh tokens are rotated automatically.

JavaScript / fetch
// Every request needs a Bearer token in the Authorization header
fetch('https://api.aionbooking.com/api/bookings', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ business_id, service_id, date, time }),
});

API Explorer

All endpoints are prefixed with https://api.aionbooking.com.

Businesses
GET/api/businessesList all businesses with pagination and filtering
GET/api/businesses/:slugGet a single business by slug
Bookings
POST/api/bookingsCreate a new booking
GET/api/bookings/:idGet booking details by ID
PATCH/api/bookings/:id/statusUpdate booking status (confirm, cancel, complete)
Services
GET/api/servicesList services for a business
POST/api/servicesCreate a new service offering
Availability
GET/api/availabilityQuery available time slots for a service
Payments
POST/api/payments/stripe/create-payment-intentCreate a Stripe PaymentIntent for a booking
POST/api/payments/paystack/initializeInitialize a Paystack transaction
Webhooks
POST/api/payments/stripe/webhookStripe event webhook — validate signature server-side
POST/api/payments/paystack/webhookPaystack event webhook — validate HMAC signature

Create a Booking

A minimal cURL example to create a booking. The server always calculates price server-side — never pass a price from the client.

cURL
curl -X POST https://api.aionbooking.com/api/bookings \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "biz_abc123",
    "service_id":  "svc_xyz789",
    "date":        "2026-03-15",
    "time":        "14:00"
  }'

SDKs & Libraries

Use the REST API with any language today. Official convenience SDKs are on the roadmap.

REST API
Any language
JavaScript SDK
Coming soon
Python SDK
Coming soon

Rate Limiting

Rate limits are applied per API key. Exceeded requests return a 429 Too Many Requests response with a Retry-After header.

Free plan
100 requests / minute
Paid plan
1,000 requests / minute

Ready to build?

Get your API key and start building in minutes. Full documentation with interactive examples is waiting for you.

Get API Key View Docs