API collection for UrbanMove Corporate Shuttle Platform
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50839381","collectionId":"9bee699d-3e1c-4bdf-80c2-38352124eb8a","publishedId":"2sBXqKoLCy","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-02T12:31:36.000Z"},"item":[{"name":"Auth","item":[{"name":"Login (Admin)","id":"e0b4f59f-5e09-4895-be33-416fef184a34","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"admin@urbanmove.com\",\n \"password\": \"Admin1234\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/auth/login","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"9bee699d-3e1c-4bdf-80c2-38352124eb8a","id":"9bee699d-3e1c-4bdf-80c2-38352124eb8a","name":"UrbanMove API","type":"collection"}},"urlObject":{"path":["auth","login"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0b4f59f-5e09-4895-be33-416fef184a34"},{"name":"Login (Employee)","id":"c260a55c-daed-4470-ab77-3ca86979b8da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"demo@urbanmove.com\",\n \"password\": \"Demo1234\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/auth/login","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"9bee699d-3e1c-4bdf-80c2-38352124eb8a","id":"9bee699d-3e1c-4bdf-80c2-38352124eb8a","name":"UrbanMove API","type":"collection"}},"urlObject":{"path":["auth","login"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"c260a55c-daed-4470-ab77-3ca86979b8da"}],"id":"51f1ad30-53c2-4874-a6ca-2f151502dc7e","description":"StartFragment# 🚀 UrbanMove API Documentation
Welcome to the UrbanMove API documentation. This guide provides everything you need to test and integrate with the corporate shuttle platform backend.
## 📌 Base URLAll API requests should be made to:`http://localhost:5000/api\\`
---
## 🛠️ Quick Start (Postman)To make testing easier, I have provided a pre-configured Postman Collection.
1. Locate the file `UrbanMove.postman_collection.json` in the project root.2. Open Postman and click Import.3. Drag and drop the file.4. The collection includes Automatic Token Handling—just login, and other routes will work automatically!
---
## 🔐 AuthenticationThe API uses JWT (JSON Web Tokens) for security.
### Demo CredentialsUse these accounts to test different roles without needing a database setup:
| Role | Email | Password || :--- | :--- | :--- || Admin | `admin@urbanmove.com` | `Admin1234` || Driver | `driver@urbanmove.com` | `Driver1234` || Employee | `demo@urbanmove.com` | `Demo1234` |
### How to AuthenticateInclude the token in the request header:`Authorization: Bearer `
---
## 📡 Key Endpoints
### 1. Authentication* `POST /auth/login`: Authenticate a user and receive a token.* `POST /auth/logout`: Terminate the current session.
### 2. User Profile* `GET /users/profile`: Get current user details (Protected).* `PUT /users/profile`: Update user information.
### 3. Rides* `GET /rides`: List all rides (Returns dummy data if DB is empty).* `POST /rides`: Book a new shuttle ride.* `PUT /rides/:id/cancel`: Cancel a pending ride.
### 4. Admin Panel* `GET /admin/stats`: Get system-wide statistics (Users, Rides, Vehicles).* `GET /admin/users`: List and manage all registered users.
### 5. Vehicles & Notifications* `GET /vehicles`: List available shuttle vehicles.* `GET /notifications`: Get real-time alerts and updates.
---
## 💡 Smart Fallback DataTo ensure a great presentation, the API is equipped with Smart Fallbacks. If your MongoDB database is empty, the following routes will automatically return professional dummy data:* `GET /api/admin/stats`* `GET /api/rides`* `GET /api/notifications`* `GET /api/vehicles`
---
## 🚦 Health CheckTo verify if the server is running, visit:`http://localhost:5000/api/health\\`
EndFragment