✈️ api.faringani.com · Firebase Cloud Functions

The API powering
seamless travel
across Nigeria

Farin Gani Travel & Tours backend — authentication, VISA packages, bookings, payments, staff management, and deep linking. Built on Firebase.

🚀 Explore Endpoints 📬 Contact Team
Farin Gani API — Endpoint Explorer
# ── Authentication ──────────────────────────────
POST /v1/auth/register # Create account
POST /v1/auth/login # Sign in, returns JWT
GET /v1/auth/me # Current user profile
 
# ── VISA Packages ───────────────────────────────
GET /v1/packages # List all packages
GET /v1/packages/:id # Package detail
POST /v1/packages/:id/apply # Apply for package
 
# ── Payments ────────────────────────────────────
POST /v1/payments/initiate # Start payment (Flutterwave)
GET /v1/payments/verify # Verify transaction
 
# ── Deep Links ──────────────────────────────────
GET /v1/share/:token # Smart app redirect
 
→ All endpoints require Bearer token except /auth
BASE URL https://api.faringani.com/v1
30+
API Endpoints
99.9%
Uptime SLA
<200ms
Avg Response Time
Firebase
Powered by GCP
What's inside
Everything you need
A complete backend for travel management — built API-first, secured by Firebase Auth.
🔐
Authentication & RBAC
JWT-based auth with role-based access control. Separate flows for clients, staff, and admins with granular permission checks.
/v1/auth
🛂
VISA Packages
Manage curated VISA travel packages — Hajj, Umrah, business, and tourist visas. Applications, documents, and status tracking.
/v1/packages
💳
Payments (Flutterwave)
Integrated Flutterwave payment gateway with webhook verification, instalment plans, and refund management.
/v1/payments
📣
Announcements & Push
FCM push notifications and in-app announcements. Topic-based broadcasts and individual user targeting.
/v1/announcements
👥
Staff Management
Full CRUD for staff accounts with suspension, permission assignment, activity audit logs, and automated email notifications.
/v1/admin/staff
🔗
Smart Deep Links
Universal link resolver that detects iOS, Android, or desktop and redirects to the correct store or web fallback.
/v1/share/:token