Magochi API

Complete API Documentation

hotel.webninjaafrica.com/api

Database Connected

Authentication

POST login
POST logout
GET me
POST refresh

Hotel Branches

POST branches
DELETE {id}
GET {id}
GET branches
PUT {id}

Human Resources

Front Office

POST guests
GET {id}
GET guests
PUT {id}
POST reservations
GET {id}
GET reservations
PUT {id}
POST rooms
DELETE {id}
GET {id}
GET rooms
PUT {id}

Payments & Billing

M-Pesa Integration

POST callback
GET status
POST stk-push

Dashboard & Analytics

GET summary

Reports

GET occupancy
GET revenue

Marketing

System Configuration

Additional Info

Error Codes
Rate Limits
Authentication
SDKs
Support
Changelog

GET

/guests

Auth Required

List Guests

Get paginated list of all guests. Search by name, email, phone.

Scopes: guest:read

Rate Limit: 60 per minute

© 2026 Magochi API - Kenya 5-Star Hotel System

Version 1.0 | Documentation Home