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

POST

/branches

Auth Required

Create Branch

Create a new hotel branch. Required role: SUPER_ADMIN or GM.

Scopes: branch:write

Rate Limit: 20 per minute

© 2026 Magochi API - Kenya 5-Star Hotel System

Version 1.0 | Documentation Home