{ "info": { "name": "🔧 Maintenance Platform — Full API Collection", "_postman_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "description": "## 🔧 Maintenance Platform — Full API Collection\n\nComplete API collection for the Maintenance Platform.\n\n### 📋 User Types\n| Type | Prefix | Auth Flow |\n|------|--------|-----------|\n| **Admin** | `/api/v1/admin/` | Email + Password (JWT) |\n| **Client** | `/api/v1/client/` | Email/Phone + Password (JWT) |\n| **Company** | `/api/v1/company/` | Email + Password (JWT) |\n| **Technician** | `/api/v1/technician/` | Email + Password (JWT) |\n\n### 🚀 Quick Start\n1. Set `base_url` variable (default: `http://localhost:8000`)\n2. Login with any user type → token auto-saved\n3. All subsequent requests auto-attach the token\n\n### 🌐 Localization\nSet `locale` variable to `en` or `ar` for English/Arabic responses.\n\n**Generated:** 2026-08-16", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "http://localhost:8000", "type": "string" }, { "key": "admin_token", "value": "", "type": "string" }, { "key": "client_token", "value": "", "type": "string" }, { "key": "company_token", "value": "", "type": "string" }, { "key": "technician_token", "value": "", "type": "string" }, { "key": "locale", "value": "en", "type": "string" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{admin_token}}", "type": "string" } ] }, "item": [ { "name": "🔧 Admin", "description": "## Admin Panel\n\nAll admin endpoints require `auth:api` + `active` + `rbac.auto` middleware.\n\n### 🔑 Credentials\n| Email | Password | Status |\n|-------|----------|--------|\n| admin@maintenance.sa | password | ✅ Active |", "item": [ { "name": "🔐 Account", "item": [ { "name": "🔑 Auth", "item": [ { "name": "Login", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/auth/login", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "auth", "login" ] }, "description": "### Admin Login\n\n**Rate Limiting:** 5 attempts/account/min\n\n**Response:** JWT token with roles and permissions", "body": { "mode": "raw", "raw": "{\n \"login\": \"admin@maintenance.sa\",\n \"password\": \"password\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "if (jsonData.status === 'success' && jsonData.data && jsonData.data.token) {", " pm.collectionVariables.set('admin_token', jsonData.data.token);", " console.log('✅ admin_token saved');", "} else {", " console.log('❌ Failed: ' + (jsonData.message || 'Unknown'));", "}" ] } } ] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/auth/logout", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "auth", "logout" ] }, "description": "Invalidate JWT token", "body": { "mode": "raw", "raw": "{\n \"device_id\": \"optional-device-id\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "👤 Profile", "item": [ { "name": "View Profile", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "profile" ] }, "description": "View admin profile with roles and permissions" }, "response": [] }, { "name": "Update Profile", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "profile" ] }, "description": "Update admin profile", "body": { "mode": "raw", "raw": "{\n \"name\": \"Super Admin\",\n \"email\": \"admin@maintenance.sa\",\n \"phone\": \"+966500000000\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Change Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/profile/change-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "profile", "change-password" ] }, "description": "Change admin password", "body": { "mode": "raw", "raw": "{\n \"current_password\": \"password\",\n \"password\": \"newpassword123\",\n \"password_confirmation\": \"newpassword123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] } ] }, { "name": "📊 System", "item": [ { "name": "🏥 Health", "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/health", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "health" ] }, "description": "**Route:** `shared.health.index`\n**Middleware:** none (public)\n\nLiveness check for the API — returns service status. No authentication required." }, "response": [] } ] }, { "name": "⚙️ Config", "item": [ { "name": "Bootstrap", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/config/bootstrap", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "config", "bootstrap" ] }, "description": "**Route:** `shared.config.bootstrap`\n**Middleware:** none (public)\n\nReturns app bootstrap configuration (feature flags, supported locales, min app version, etc.) consumed by client apps on startup, before login. No authentication required." }, "response": [] } ] }, { "name": "📈 Dashboard", "item": [ { "name": "Dashboard", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/dashboard", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "dashboard" ] }, "description": "Admin dashboard overview" }, "response": [] }, { "name": "Companies", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/dashboard/companies", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "dashboard", "companies" ] }, "description": "Company-specific dashboard stats" }, "response": [] }, { "name": "Technicians", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/dashboard/technicians", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "dashboard", "technicians" ] }, "description": "Technician-specific dashboard stats" }, "response": [] } ] }, { "name": "⚙️ Settings", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/settings", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "settings" ] }, "description": "List all settings" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/settings", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "settings" ] }, "description": "Update settings", "body": { "mode": "raw", "raw": "{\n \"key\": \"value\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "🚩 Feature Flags", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/feature-flags", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "feature-flags" ] }, "description": "List feature flags" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/feature-flags", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "feature-flags" ] }, "description": "Create feature flag", "body": { "mode": "raw", "raw": "{\n \"key\": \"new_feature\",\n \"is_enabled\": true,\n \"description\": \"New feature flag\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/feature-flags/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "feature-flags", ":id" ] }, "description": "Update feature flag", "body": { "mode": "raw", "raw": "{\n \"is_enabled\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/feature-flags/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "feature-flags", ":id" ] }, "description": "Delete feature flag" }, "response": [] }, { "name": "Toggle", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/feature-flags/:id/toggle", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "feature-flags", ":id", "toggle" ] }, "description": "Toggle feature flag" }, "response": [] } ] }, { "name": "📋 Audit Logs", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/audit-logs", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "audit-logs" ] }, "description": "List audit logs" }, "response": [] } ] } ] }, { "name": "📄 Content", "item": [ { "name": "❓ FAQs", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/faqs", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "faqs" ] }, "description": "List FAQs" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/faqs", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "faqs" ] }, "description": "Create FAQ", "body": { "mode": "raw", "raw": "{\n \"question\": \"How to use?\",\n \"answer\": \"Follow the guide.\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/faqs/:faq", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "faqs", ":faq" ] }, "description": "Show FAQ" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/faqs/:faq", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "faqs", ":faq" ] }, "description": "Update FAQ", "body": { "mode": "raw", "raw": "{\n \"question\": \"Updated question\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/faqs/:faq", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "faqs", ":faq" ] }, "description": "Delete FAQ" }, "response": [] } ] }, { "name": "📄 Pages", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/pages", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "pages" ] }, "description": "List static pages" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/pages", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "pages" ] }, "description": "Create page", "body": { "mode": "raw", "raw": "{\n \"title\": \"About Us\",\n \"slug\": \"about-us\",\n \"content\": \"Page content\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/pages/:page", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "pages", ":page" ] }, "description": "Show page" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/pages/:page", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "pages", ":page" ] }, "description": "Update page", "body": { "mode": "raw", "raw": "{\n \"title\": \"Updated Title\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/pages/:page", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "pages", ":page" ] }, "description": "Delete page" }, "response": [] } ] }, { "name": "🖼️ Sliders", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/sliders", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "sliders" ] }, "description": "List sliders" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/sliders", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "sliders" ] }, "description": "Create slider", "body": { "mode": "raw", "raw": "{\n \"title\": \"Banner 1\",\n \"image\": \"media-id\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/sliders/:slider", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "sliders", ":slider" ] }, "description": "Show slider" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/sliders/:slider", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "sliders", ":slider" ] }, "description": "Update slider", "body": { "mode": "raw", "raw": "{\n \"title\": \"Updated Banner\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/sliders/:slider", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "sliders", ":slider" ] }, "description": "Delete slider" }, "response": [] } ] }, { "name": "📂 Categories", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/categories", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "categories" ] }, "description": "List categories" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/categories", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "categories" ] }, "description": "Create category", "body": { "mode": "raw", "raw": "{\n \"name\": \"Plumbing\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/categories/:category", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "categories", ":category" ] }, "description": "Show category" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/categories/:category", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "categories", ":category" ] }, "description": "Update category", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Category\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/categories/:category", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "categories", ":category" ] }, "description": "Delete category" }, "response": [] } ] }, { "name": "🔧 Services", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/services", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "services" ] }, "description": "List services" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/services", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "services" ] }, "description": "Create service", "body": { "mode": "raw", "raw": "{\n \"name\": \"Pipe Repair\",\n \"category_id\": 1,\n \"price\": 100\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/services/:service", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "services", ":service" ] }, "description": "Show service" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/services/:service", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "services", ":service" ] }, "description": "Update service", "body": { "mode": "raw", "raw": "{\n \"price\": 150\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/services/:service", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "services", ":service" ] }, "description": "Delete service" }, "response": [] } ] } ] }, { "name": "🌍 Geo", "item": [ { "name": "🏳️ Countries", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/countries", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "countries" ] }, "description": "List countries" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/countries", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "countries" ] }, "description": "Create country", "body": { "mode": "raw", "raw": "{\n \"name\": \"Saudi Arabia\",\n \"code\": \"SA\",\n \"phone_code\": \"+966\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/countries/:country", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "countries", ":country" ] }, "description": "Show country" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/countries/:country", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "countries", ":country" ] }, "description": "Update country", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Name\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/countries/:country", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "countries", ":country" ] }, "description": "Delete country" }, "response": [] } ] }, { "name": "🏙️ Governorates", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/governorates", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "governorates" ] }, "description": "List governorates" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/governorates", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "governorates" ] }, "description": "Create governorate", "body": { "mode": "raw", "raw": "{\n \"name\": \"Riyadh\",\n \"country_id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/governorates/:governorate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "governorates", ":governorate" ] }, "description": "Show governorate" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/governorates/:governorate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "governorates", ":governorate" ] }, "description": "Update governorate", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Name\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/governorates/:governorate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "governorates", ":governorate" ] }, "description": "Delete governorate" }, "response": [] } ] }, { "name": "📍 Regions", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/regions", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "regions" ] }, "description": "List regions" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/regions", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "regions" ] }, "description": "Create region", "body": { "mode": "raw", "raw": "{\n \"name\": \"Al Malqa\",\n \"governorate_id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/regions/:region", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "regions", ":region" ] }, "description": "Show region" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/regions/:region", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "regions", ":region" ] }, "description": "Update region", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Name\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/regions/:region", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "regions", ":region" ] }, "description": "Delete region" }, "response": [] } ] }, { "name": "📦 Shipping Zones", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/shipping-zones", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "shipping-zones" ] }, "description": "List shipping zones" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/shipping-zones", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "shipping-zones" ] }, "description": "Create shipping zone", "body": { "mode": "raw", "raw": "{\n \"name\": \"Zone 1\",\n \"region_id\": 1,\n \"shipping_fee\": 25\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/shipping-zones/:shipping_zone", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "shipping-zones", ":shipping_zone" ] }, "description": "Show shipping zone" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/shipping-zones/:shipping_zone", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "shipping-zones", ":shipping_zone" ] }, "description": "Update shipping zone", "body": { "mode": "raw", "raw": "{\n \"shipping_fee\": 30\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/shipping-zones/:shipping_zone", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "shipping-zones", ":shipping_zone" ] }, "description": "Delete shipping zone" }, "response": [] } ] } ] }, { "name": "👥 Access", "item": [ { "name": "👤 Users", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users?search=&status=&user_type=&specialty=&availability_status=&min_rating=&min_completed_orders=&from=&to=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users" ], "query": [ { "key": "search", "value": "", "description": "Search by name, email, or phone" }, { "key": "status", "value": "", "description": "Filter: active, suspended, pending, rejected" }, { "key": "user_type", "value": "", "description": "Filter: individual, company, technician" }, { "key": "specialty", "value": "", "description": "Filter by technician specialty (e.g. hvac, electrical, plumbing)" }, { "key": "availability_status", "value": "", "description": "Filter: available, unavailable, en_route, working" }, { "key": "min_rating", "value": "", "description": "Filter technicians with rating >= this value" }, { "key": "min_completed_orders", "value": "", "description": "Filter technicians with completed orders >= this value" }, { "key": "from", "value": "", "description": "Filter from date (YYYY-MM-DD)" }, { "key": "to", "value": "", "description": "Filter to date (YYYY-MM-DD)" }, { "key": "per_page", "value": "15", "description": "Results per page (1-100)" } ] }, "description": "List all users with filtering. Filter by user_type: individual (clients), company, technician." }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users" ] }, "description": "Create user", "body": { "mode": "raw", "raw": "{\n \"name\": \"New User\",\n \"email\": \"user@test.com\",\n \"user_type\": \"individual\",\n \"password\": \"password123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users/:user", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users", ":user" ] }, "description": "Show user" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users/:user", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users", ":user" ] }, "description": "Update user", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Name\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users/:user", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users", ":user" ] }, "description": "Delete user" }, "response": [] }, { "name": "Toggle Active", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users/:id/toggle-active", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users", ":id", "toggle-active" ] }, "description": "Toggle user active status" }, "response": [] }, { "name": "Activate", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users/:id/activate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users", ":id", "activate" ] }, "description": "Activate user" }, "response": [] }, { "name": "Reject", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/users/:id/reject", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "users", ":id", "reject" ] }, "description": "Reject user" }, "response": [] } ] }, { "name": "🛡️ Roles", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/roles", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "roles" ] }, "description": "List roles" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/roles", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "roles" ] }, "description": "Create role", "body": { "mode": "raw", "raw": "{\n \"name\": \"editor\",\n \"description\": \"Content editor\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/roles/:role", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "roles", ":role" ] }, "description": "Show role" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/roles/:role", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "roles", ":role" ] }, "description": "Update role", "body": { "mode": "raw", "raw": "{\n \"name\": \"senior_editor\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/roles/:role", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "roles", ":role" ] }, "description": "Delete role" }, "response": [] } ] }, { "name": "🔑 Permissions", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/permissions", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "permissions" ] }, "description": "List all permissions" }, "response": [] } ] }, { "name": "👤 Supervisors", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/supervisors", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "supervisors" ] }, "description": "List supervisors" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/supervisors", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "supervisors" ] }, "description": "Create supervisor", "body": { "mode": "raw", "raw": "{\n \"name\": \"Supervisor\",\n \"email\": \"super@test.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/supervisors/:supervisor", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "supervisors", ":supervisor" ] }, "description": "Show supervisor" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/supervisors/:supervisor", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "supervisors", ":supervisor" ] }, "description": "Update supervisor", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Name\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/supervisors/:supervisor", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "supervisors", ":supervisor" ] }, "description": "Delete supervisor" }, "response": [] } ] }, { "name": "📍 Addresses", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "addresses" ] }, "description": "List all addresses with filters" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "addresses" ] }, "description": "Create a new address", "body": { "mode": "raw", "raw": "{\n \"user_id\": 1,\n \"label\": \"Home\",\n \"latitude\": 24.7136,\n \"longitude\": 46.6753,\n \"city_id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/addresses/:address", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "addresses", ":address" ] }, "description": "Show address details" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/addresses/:address", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "addresses", ":address" ] }, "description": "Update address", "body": { "mode": "raw", "raw": "{\n \"label\": \"Office\",\n \"latitude\": 24.72,\n \"longitude\": 46.68\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/addresses/:address", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "addresses", ":address" ] }, "description": "Delete address" }, "response": [] } ] } ] }, { "name": "💬 Communication", "item": [ { "name": "🔔 Notifications", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/notifications", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "notifications" ] }, "description": "List admin notifications" }, "response": [] }, { "name": "Send", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/notifications/send", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "notifications", "send" ] }, "description": "Send notification", "body": { "mode": "raw", "raw": "{\n \"title\": \"Test\",\n \"message\": \"Hello\",\n \"user_ids\": [\n 1\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📩 Contact Messages", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contact-messages", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contact-messages" ] }, "description": "List contact messages" }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contact-messages/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contact-messages", ":id" ] }, "description": "Show contact message" }, "response": [] }, { "name": "Reply", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contact-messages/:id/reply", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contact-messages", ":id", "reply" ] }, "description": "Reply to contact message", "body": { "mode": "raw", "raw": "{\n \"reply\": \"Thank you for contacting us.\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contact-messages/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contact-messages", ":id" ] }, "description": "Delete contact message" }, "response": [] } ] } ] }, { "name": "💰 Wallet & Finance", "item": [ { "name": "💳 Wallets", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets" ] }, "description": "List all wallets" }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets", ":id" ] }, "description": "Show wallet details" }, "response": [] }, { "name": "Credit", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets/:id/credit", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets", ":id", "credit" ] }, "description": "Credit wallet", "body": { "mode": "raw", "raw": "{\n \"amount\": 100,\n \"reason\": \"Bonus credit\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Transactions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets/:id/transactions?type=&status=&from_date=&to_date=&order_number=&per_page=20", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets", ":id", "transactions" ], "query": [ { "key": "type", "value": "", "description": "Filter: refund_credit, manual_credit, order_debit, reversal" }, { "key": "status", "value": "", "description": "Filter: pending, completed, failed" }, { "key": "from_date", "value": "", "description": "Start date (YYYY-MM-DD)" }, { "key": "to_date", "value": "", "description": "End date (YYYY-MM-DD)" }, { "key": "order_number", "value": "", "description": "Filter by order number" }, { "key": "per_page", "value": "20", "description": "Results per page (1-100)" } ] }, "description": "Get filtered transaction history for a wallet" }, "response": [] }, { "name": "Block Refund", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets/:id/block-refund", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets", ":id", "block-refund" ] }, "description": "Block a pending refund for an ineligible order", "body": { "mode": "raw", "raw": "{\n \"order_id\": 1,\n \"reason\": \"Order not eligible for refund\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Lock Wallet", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets/:id/lock", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets", ":id", "lock" ] }, "description": "Lock wallet to prevent any usage or withdrawal" }, "response": [] }, { "name": "Unlock Wallet", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/wallets/:id/unlock", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "wallets", ":id", "unlock" ] }, "description": "Unlock a previously locked wallet" }, "response": [] } ] }, { "name": "💸 Withdraw Requests", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/withdraw-requests", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "withdraw-requests" ] }, "description": "List withdraw requests" }, "response": [] }, { "name": "Approve", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/withdraw-requests/:id/approve", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "withdraw-requests", ":id", "approve" ] }, "description": "Approve withdraw request" }, "response": [] }, { "name": "Reject", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/withdraw-requests/:id/reject", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "withdraw-requests", ":id", "reject" ] }, "description": "Reject withdraw request", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Insufficient documents\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📋 Contracts", "description": "Admin contract management", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts?status=&company_id=&search=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts" ] }, "description": "List all contracts" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts?status=&company_id=&search=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts" ] }, "description": "List all contracts" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contracts retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts?status=&company_id=&search=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts" ] }, "description": "List all contracts" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع العقود بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Show contract details" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Show contract details" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Show contract details" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts" ] }, "description": "Create contract", "body": { "mode": "raw", "raw": "{\n \"company_id\": 10,\n \"start_date\": \"2026-09-01\",\n \"end_date\": \"2027-08-31\",\n \"billing_cycle\": \"monthly\",\n \"currency\": \"SAR\",\n \"visits_allowed\": 24,\n \"auto_renew\": false,\n \"notes\": \"Annual maintenance contract\",\n \"signed_media_id\": 5,\n \"branches\": [\n {\n \"branch_id\": 1,\n \"service_ids\": [\n 1,\n 2\n ],\n \"visits_allowed\": 12\n },\n {\n \"branch_id\": 2,\n \"service_ids\": [\n 3\n ],\n \"visits_allowed\": 12\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts" ] }, "description": "Create contract", "body": { "mode": "raw", "raw": "{\n \"company_id\": 1,\n \"service_ids\": [\n 1\n ],\n \"branch_ids\": [\n 1\n ],\n \"start_date\": \"2026-09-01\",\n \"end_date\": \"2027-08-31\",\n \"billing_cycle\": \"monthly\",\n \"visits_allowed\": 12,\n \"total_amount\": 12000\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract created successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts" ] }, "description": "Create contract", "body": { "mode": "raw", "raw": "{\n \"company_id\": 1,\n \"service_ids\": [\n 1\n ],\n \"branch_ids\": [\n 1\n ],\n \"start_date\": \"2026-09-01\",\n \"end_date\": \"2027-08-31\",\n \"billing_cycle\": \"monthly\",\n \"visits_allowed\": 12,\n \"total_amount\": 12000\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم إنشاء العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Update contract", "body": { "mode": "raw", "raw": "{\n \"total_amount\": 15000\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Update contract", "body": { "mode": "raw", "raw": "{\n \"total_amount\": 15000\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract updated successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Update contract", "body": { "mode": "raw", "raw": "{\n \"total_amount\": 15000\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم تحديث العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Delete contract" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Delete contract" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract deleted successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id" ] }, "description": "Delete contract" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم حذف العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Approve", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/approve", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "approve" ] }, "description": "Approve pending_approval -> active" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/approve", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "approve" ] }, "description": "Approve pending_approval -> active" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract approved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/approve", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "approve" ] }, "description": "Approve pending_approval -> active" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تمت الموافقة على العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Reject", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/reject", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "reject" ] }, "description": "Reject with reason", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Incomplete docs\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/reject", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "reject" ] }, "description": "Reject with reason", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Incomplete docs\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract rejected successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/reject", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "reject" ] }, "description": "Reject with reason", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Incomplete docs\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم رفض العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Terminate", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/terminate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "terminate" ] }, "description": "Terminate active contract", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Company request\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/terminate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "terminate" ] }, "description": "Terminate active contract", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Company request\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract terminated successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/terminate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "terminate" ] }, "description": "Terminate active contract", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Company request\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم إنهاء العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Renewal Action", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/renewal/:action", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "renewal", ":action" ], "variable": [ { "key": "id", "value": "1", "description": "Contract ID" }, { "key": "action", "value": "approve", "description": "approve or reject" } ] }, "description": "Approve or reject a pending renewal request (:action = approve|reject)" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/renewal/:action", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "renewal", ":action" ], "variable": [ { "key": "id", "value": "1", "description": "Contract ID" }, { "key": "action", "value": "approve", "description": "approve or reject" } ] }, "description": "Approve or reject a pending renewal request (:action = approve|reject)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Renewal approved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/contracts/:id/renewal/:action", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "contracts", ":id", "renewal", ":action" ], "variable": [ { "key": "id", "value": "1", "description": "Contract ID" }, { "key": "action", "value": "approve", "description": "approve or reject" } ] }, "description": "Approve or reject a pending renewal request (:action = approve|reject)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تمت الموافقة على التجديد بنجاح.\",\n \"data\": {}\n}" } ] } ] } ] }, { "name": "🏢 Branches", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches?search=&company_id=&is_active=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches?search=&company_id=&is_active=&per_page=15" ] }, "description": "List all branches with filtering" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches?search=&company_id=&is_active=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches?search=&company_id=&is_active=&per_page=15" ] }, "description": "List all branches with filtering" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branches retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches?search=&company_id=&is_active=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches?search=&company_id=&is_active=&per_page=15" ] }, "description": "List all branches with filtering" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع الفروع بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches" ] }, "description": "Create a new branch", "body": { "mode": "raw", "raw": "{\n \"company_id\": 1,\n \"name\": \"Main Branch\",\n \"address_line\": \"123 King Fahd Road\",\n \"latitude\": 24.7136,\n \"longitude\": 46.6753,\n \"allowed_slots\": [\n \"morning\",\n \"afternoon\"\n ],\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ],\n \"working_hours\": [\n {\n \"day\": \"sunday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"monday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"tuesday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"wednesday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"thursday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"saturday\",\n \"from\": \"09:00\",\n \"to\": \"14:00\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches" ] }, "description": "Create a new branch", "body": { "mode": "raw", "raw": "{\n \"company_id\": 1,\n \"name\": \"Main Branch\",\n \"address_line\": \"123 King Fahd Road\",\n \"latitude\": 24.7136,\n \"longitude\": 46.6753,\n \"working_hours_from\": \"09:00\",\n \"working_hours_to\": \"17:00\",\n \"allowed_slots\": [\n \"morning\",\n \"afternoon\"\n ],\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branch created successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches" ] }, "description": "Create a new branch", "body": { "mode": "raw", "raw": "{\n \"company_id\": 1,\n \"name\": \"Main Branch\",\n \"address_line\": \"123 King Fahd Road\",\n \"latitude\": 24.7136,\n \"longitude\": 46.6753,\n \"working_hours_from\": \"09:00\",\n \"working_hours_to\": \"17:00\",\n \"allowed_slots\": [\n \"morning\",\n \"afternoon\"\n ],\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم إنشاء الفرع بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Show branch details with contacts" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Show branch details with contacts" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branch retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Show branch details with contacts" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع الفرع بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Update branch", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Branch\",\n \"address_line\": \"456 Updated Road\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Update branch", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Branch\",\n \"address_line\": \"456 Updated Road\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branch updated successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Update branch", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Branch\",\n \"address_line\": \"456 Updated Road\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم تحديث الفرع بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Delete branch (BR-12: only if no scheduled visits/contracts)" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Delete branch (BR-12: only if no scheduled visits/contracts)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branch deleted successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":branch" ] }, "description": "Delete branch (BR-12: only if no scheduled visits/contracts)" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم حذف الفرع بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Toggle Active", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:id/toggle-active", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":id", "toggle-active" ] }, "description": "Toggle branch active/inactive" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:id/toggle-active", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":id", "toggle-active" ] }, "description": "Toggle branch active/inactive" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branch activated successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:id/toggle-active", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":id", "toggle-active" ] }, "description": "Toggle branch active/inactive" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم تفعيل الفرع بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Update Contacts", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:id/contacts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":id", "contacts" ] }, "description": "Add or update branch contacts", "body": { "mode": "raw", "raw": "{\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:id/contacts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":id", "contacts" ] }, "description": "Add or update branch contacts", "body": { "mode": "raw", "raw": "{\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Branch contacts updated successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/branches/:id/contacts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "branches", ":id", "contacts" ] }, "description": "Add or update branch contacts", "body": { "mode": "raw", "raw": "{\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم تحديث جهات اتصال الفرع بنجاح.\",\n \"data\": {}\n}" } ] } ] }, { "name": "🏭 Companies", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies?search=&status=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies?search=&status=&per_page=15" ] }, "description": "List all companies with filtering" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies" ] }, "description": "Create a new company", "body": { "mode": "raw", "raw": "{\n \"name\": \"New Company\",\n \"email\": \"new@company.com\",\n \"phone\": \"966509999999\",\n \"password\": \"password\",\n \"legal_name\": \"New Company Trading LLC\",\n \"tax_number\": \"VAT999999999\",\n \"commercial_registration_no\": \"CR999999999\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies/:company", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies", ":company" ] }, "description": "Show company details with profile" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies/:company", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies", ":company" ] }, "description": "Update company", "body": { "mode": "raw", "raw": "{\n \"legal_name\": \"Updated Company LLC\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies/:company", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies", ":company" ] }, "description": "Delete company" }, "response": [] }, { "name": "Activate", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies/:id/activate", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies", ":id", "activate" ] }, "description": "Activate company (pending → active)" }, "response": [] }, { "name": "Reject", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies/:id/reject", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies", ":id", "reject" ] }, "description": "Reject company (pending → rejected)", "body": { "mode": "raw", "raw": "{\n \"reason\": \"Incomplete documents\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Toggle Active", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/companies/:id/toggle-active", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "companies", ":id", "toggle-active" ] }, "description": "Toggle company active/suspended" }, "response": [] } ] }, { "name": "🔧 Technicians", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians?search=&status=&category_id=&employment_type=&availability_status=&city=&min_rating=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians?search=&status=&category_id=&employment_type=&availability_status=&city=&min_rating=&per_page=15" ] }, "description": "List all technicians with filtering" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians" ] }, "description": "Create a new technician", "body": { "mode": "raw", "raw": "{\n \"name\": \"New Technician\",\n \"email\": \"new.tech@example.com\",\n \"phone\": \"966501111111\",\n \"password\": \"password\",\n \"full_name\": \"New Technician\",\n \"category_id\": 1,\n \"coverage_areas\": [\n 1,\n 2\n ],\n \"years_experience\": 3,\n \"daily_order_capacity\": 5,\n \"employment_type\": \"in_house\",\n \"city\": \"Riyadh\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians/:technician", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians", ":technician" ] }, "description": "Show technician details with profile and stats" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians/:technician", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians", ":technician" ] }, "description": "Update technician", "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Updated Name\",\n \"daily_order_capacity\": 8\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians/:technician", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians", ":technician" ] }, "description": "Delete technician (soft delete)" }, "response": [] }, { "name": "Toggle Status", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians/:id/toggle-status", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians", ":id", "toggle-status" ] }, "description": "Toggle technician active/suspended" }, "response": [] }, { "name": "Toggle Availability", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/admin/technicians/:id/toggle-availability", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "admin", "technicians", ":id", "toggle-availability" ] }, "description": "Toggle technician available/unavailable" }, "response": [] } ] }, { "name": "🔔 Notifications", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.notifications.index`\n**Middleware:** `auth:api, active`\n\nList the authenticated user's notifications, newest first." }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.show`\n**Middleware:** `auth:api, active`\n\nShow a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.destroy`\n**Middleware:** `auth:api, active`\n\nDelete a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Mark All Read", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/mark-all-read", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "mark-all-read" ] }, "description": "**Route:** `shared.notifications.mark-all-read`\n**Middleware:** `auth:api, active`\n\nMarks every unread notification for the authenticated user as read. No request body." }, "response": [] }, { "name": "Clear All", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/clear-all", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "clear-all" ] }, "description": "**Route:** `shared.notifications.clear-all`\n**Middleware:** `auth:api, active`\n\nDeletes every notification for the authenticated user. No request body." }, "response": [] } ] }, { "name": "📸 Media", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/media?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "media" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.media.index`\n**Middleware:** `auth:api, active`\n\nList media uploaded by the authenticated user. Cross-role endpoint — reachable by any authenticated user type." }, "response": [] }, { "name": "Upload", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/media", "host": [ "{{base_url}}" ], "path": [ "media" ] }, "description": "**Route:** `shared.media.store`\n**Middleware:** `auth:api, active`\n\nSend as `multipart/form-data`. Returns the created media record, whose `id`/`hash` is used by other endpoints that reference an uploaded file (e.g. profile `image`, ID scans).\n\n**Fields:**\n- `file` (file, required) — the file to upload. Max 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav.\n- `collection` (string, optional) — logical bucket to group the upload under (e.g. avatars, id_scans, cv).", "body": { "mode": "formdata", "formdata": [ { "key": "file", "type": "file", "src": "", "description": "Type: file | Required: required\nRules: required|file|max:10240|mimes:jpg,jpeg,png,gif,webp,pdf,avi,mov,wmv,flv,mkv,mp4,mp3,wav\nMax size 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav." }, { "key": "collection", "type": "text", "value": "avatars", "description": "Type: string | Required: optional\nRules: nullable|string|max:255\nLogical bucket to group the upload under (e.g. avatars, id_scans, cv)." } ] } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{admin_token}}" } ], "url": { "raw": "{{base_url}}/media/:media_id", "host": [ "{{base_url}}" ], "path": [ "media", ":media_id" ] }, "description": "**Route:** `shared.media.destroy`\n**Middleware:** `auth:api, active`\n\nDeletes a media record by id. Only the uploader (or an admin) may delete it." }, "response": [] } ] } ] }, { "name": "📱 Client", "description": "## Client App\n\nAll client endpoints require `auth:api` + `active` middleware.\n\n### 🔑 Credentials\n| Email | Password | Status |\n|-------|----------|--------|\n| client@test.com | password | ✅ Active |", "item": [ { "name": "🔐 Account", "item": [ { "name": "🔑 Auth", "item": [ { "name": "Register", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/register", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "register" ] }, "description": "Register new client account", "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Test User\",\n \"email\": \"newuser@test.com\",\n \"phone\": \"+966509999999\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Verify", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "verify" ] }, "description": "Verify account with OTP", "body": { "mode": "raw", "raw": "{\n \"login\": \"newuser@test.com\",\n \"code\": \"123456\",\n \"token\": \"token-from-register\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Resend Code", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "resend-code" ] }, "description": "Resend verification code", "body": { "mode": "raw", "raw": "{\n \"verification_token\": \"token-from-register\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Login", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/login", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "login" ] }, "description": "Login and get JWT token", "body": { "mode": "raw", "raw": "{\n \"login\": \"client@test.com\",\n \"password\": \"password\",\n \"device_id\": \"device-001\",\n \"device_type\": \"android\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "if (jsonData.status === 'success' && jsonData.data && jsonData.data.token) {", " pm.collectionVariables.set('client_token', jsonData.data.token);", " console.log('✅ client_token saved');", "} else {", " console.log('❌ Failed: ' + (jsonData.message || 'Unknown'));", "}" ] } } ] }, { "name": "Refresh Token", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/refresh", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "refresh" ] }, "description": "Refresh JWT token" }, "response": [] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/logout", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "logout" ] }, "description": "Logout and invalidate token", "body": { "mode": "raw", "raw": "{\n \"device_id\": \"device-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Forgot Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/forgot-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "forgot-password" ] }, "description": "Send password reset code", "body": { "mode": "raw", "raw": "{\n \"login\": \"client@test.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reset Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/auth/reset-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "auth", "reset-password" ] }, "description": "Reset password with OTP", "body": { "mode": "raw", "raw": "{\n \"login\": \"client@test.com\",\n \"code\": \"123456\",\n \"token\": \"reset-token\",\n \"password\": \"newpass123\",\n \"password_confirmation\": \"newpass123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "👤 Profile", "item": [ { "name": "View Profile", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "profile" ] }, "description": "View client profile" }, "response": [] }, { "name": "Update Profile", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "profile" ] }, "description": "Update client profile", "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Updated Name\",\n \"email\": \"client@test.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete Account", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "profile" ] }, "description": "Soft delete client account" }, "response": [] } ] } ] }, { "name": "📍 Addresses", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "addresses" ] }, "description": "List all addresses" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "addresses" ] }, "description": "Create new address", "body": { "mode": "raw", "raw": "{\n \"title\": \"Home\",\n \"address\": \"123 Main St\",\n \"latitude\": 24.7136,\n \"longitude\": 46.6753\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/addresses/:address", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "addresses", ":address" ] }, "description": "Show address details" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/addresses/:address", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "addresses", ":address" ] }, "description": "Update address", "body": { "mode": "raw", "raw": "{\n \"title\": \"Office\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/addresses/:address", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "addresses", ":address" ] }, "description": "Delete address" }, "response": [] }, { "name": "Set Default", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/addresses/:address/default", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "addresses", ":address", "default" ] }, "description": "Set address as default" }, "response": [] } ] }, { "name": "💳 Wallet", "item": [ { "name": "Balance", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/wallet", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "wallet" ] }, "description": "Get wallet balance" }, "response": [] }, { "name": "Transactions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/wallet/transactions?type=&status=&from_date=&to_date=&per_page=20", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "wallet", "transactions" ], "query": [ { "key": "type", "value": "", "description": "Filter: refund_credit, order_debit" }, { "key": "status", "value": "", "description": "Filter: pending, completed, failed" }, { "key": "from_date", "value": "", "description": "Start date (YYYY-MM-DD)" }, { "key": "to_date", "value": "", "description": "End date (YYYY-MM-DD)" }, { "key": "per_page", "value": "20", "description": "Results per page (1-50)" } ] }, "description": "List wallet transactions with filtering. BR-IND-09: Ledger shows all credits and debits with date, type, amount, and state." }, "response": [] }, { "name": "Withdraw", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/wallet/withdraw", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "wallet", "withdraw" ] }, "description": "Request withdrawal", "body": { "mode": "raw", "raw": "{\n \"amount\": 50,\n \"bank_name\": \"Al Rajhi\",\n \"iban\": \"SA1234567890\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "🔍 Search", "item": [ { "name": "Suggestions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/search/suggestions", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "search", "suggestions" ] }, "description": "Get search suggestions" }, "response": [] }, { "name": "Recent", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/search/recent", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "search", "recent" ] }, "description": "Get recent searches" }, "response": [] }, { "name": "Trending", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/search/trending", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "search", "trending" ] }, "description": "Get trending searches" }, "response": [] }, { "name": "Popular", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/search/popular", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "search", "popular" ] }, "description": "Get popular searches" }, "response": [] }, { "name": "Search", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/search?q=&category_id=&city_id=", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "search?q=&category_id=&city_id=" ] }, "description": "Full-text search across services" }, "response": [] } ] }, { "name": "🔔 Notifications", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/notifications?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "notifications" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.notifications.index`\n**Middleware:** `auth:api, active`\n\nList the authenticated user's notifications, newest first." }, "response": [] }, { "name": "Mark Read", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/notifications/read", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "notifications", "read" ] }, "description": "Mark notifications as read", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n 1,\n 2,\n 3\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Update Preferences", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/notifications/preferences", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "notifications", "preferences" ] }, "description": "Update notification preferences", "body": { "mode": "raw", "raw": "{\n \"allow_notifications\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Register Device", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/notifications/device", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "notifications", "device" ] }, "description": "Register device for push notifications", "body": { "mode": "raw", "raw": "{\n \"device_token\": \"fcm-token\",\n \"device_type\": \"android\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.notifications.index`\n**Middleware:** `auth:api, active`\n\nList the authenticated user's notifications, newest first." }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.show`\n**Middleware:** `auth:api, active`\n\nShow a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.destroy`\n**Middleware:** `auth:api, active`\n\nDelete a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Mark All Read", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/mark-all-read", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "mark-all-read" ] }, "description": "**Route:** `shared.notifications.mark-all-read`\n**Middleware:** `auth:api, active`\n\nMarks every unread notification for the authenticated user as read. No request body." }, "response": [] }, { "name": "Clear All", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/clear-all", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "clear-all" ] }, "description": "**Route:** `shared.notifications.clear-all`\n**Middleware:** `auth:api, active`\n\nDeletes every notification for the authenticated user. No request body." }, "response": [] } ] }, { "name": "⚙️ Settings", "item": [ { "name": "View Settings", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/settings", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "settings" ] }, "description": "View client settings" }, "response": [] }, { "name": "Update Settings", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/settings", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "settings" ] }, "description": "Update client settings", "body": { "mode": "raw", "raw": "{\n \"locale\": \"ar\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📄 Content", "item": [ { "name": "FAQs", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/faqs", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "faqs" ] }, "description": "List FAQs" }, "response": [] }, { "name": "Page", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/pages/:type", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "pages", ":type" ] }, "description": "Get static page by type" }, "response": [] }, { "name": "Sliders", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/sliders", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "sliders" ] }, "description": "List sliders" }, "response": [] }, { "name": "About Us", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/static_pages/about_us", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "static_pages", "about_us" ] }, "description": "About Us static page" }, "response": [] }, { "name": "Privacy Policy", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/static_pages/privacy_policies", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "static_pages", "privacy_policies" ] }, "description": "Privacy policy static page" }, "response": [] } ] }, { "name": "🌍 Geo", "item": [ { "name": "Countries", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/countries", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "countries" ] }, "description": "List countries" }, "response": [] }, { "name": "Governorates", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/governorates", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "governorates" ] }, "description": "List governorates" }, "response": [] }, { "name": "Regions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/regions", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "regions" ] }, "description": "List regions" }, "response": [] } ] }, { "name": "📸 General", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/media?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "media" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.media.index`\n**Middleware:** `auth:api, active`\n\nList media uploaded by the authenticated user. Cross-role endpoint — reachable by any authenticated user type." }, "response": [] }, { "name": "Upload", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/media", "host": [ "{{base_url}}" ], "path": [ "media" ] }, "description": "**Route:** `shared.media.store`\n**Middleware:** `auth:api, active`\n\nSend as `multipart/form-data`. Returns the created media record, whose `id`/`hash` is used by other endpoints that reference an uploaded file (e.g. profile `image`, ID scans).\n\n**Fields:**\n- `file` (file, required) — the file to upload. Max 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav.\n- `collection` (string, optional) — logical bucket to group the upload under (e.g. avatars, id_scans, cv).", "body": { "mode": "formdata", "formdata": [ { "key": "file", "type": "file", "src": "", "description": "Type: file | Required: required\nRules: required|file|max:10240|mimes:jpg,jpeg,png,gif,webp,pdf,avi,mov,wmv,flv,mkv,mp4,mp3,wav\nMax size 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav." }, { "key": "collection", "type": "text", "value": "avatars", "description": "Type: string | Required: optional\nRules: nullable|string|max:255\nLogical bucket to group the upload under (e.g. avatars, id_scans, cv)." } ] } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/media/:media_id", "host": [ "{{base_url}}" ], "path": [ "media", ":media_id" ] }, "description": "**Route:** `shared.media.destroy`\n**Middleware:** `auth:api, active`\n\nDeletes a media record by id. Only the uploader (or an admin) may delete it." }, "response": [] }, { "name": "Upload Media", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/upload", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "upload" ] }, "description": "Upload media file" }, "response": [] }, { "name": "Contact Us", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/contact", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "contact" ] }, "description": "Send contact message", "body": { "mode": "raw", "raw": "{\n \"name\": \"Test\",\n \"email\": \"test@test.com\",\n \"subject\": \"Help\",\n \"message\": \"I need help\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "🏠 Home", "item": [ { "name": "Home Page", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/home", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "home" ] }, "description": "Client home page with featured services, banners, and quick actions" }, "response": [] } ] }, { "name": "🛒 Cart", "item": [ { "name": "Show Cart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/cart", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "cart" ] }, "description": "View cart with items and totals" }, "response": [] }, { "name": "Add Item", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/cart/items", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "cart", "items" ] }, "description": "Add service item to cart", "body": { "mode": "raw", "raw": "{\n \"service_id\": 1,\n \"quantity\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Update Item", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/cart/items/:itemId", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "cart", "items", ":itemId" ] }, "description": "Update cart item quantity", "body": { "mode": "raw", "raw": "{\n \"quantity\": 2\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Remove Item", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/cart/items/:itemId", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "cart", "items", ":itemId" ] }, "description": "Remove item from cart" }, "response": [] }, { "name": "Clear Cart", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/cart", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "cart" ] }, "description": "Clear all items from cart" }, "response": [] }, { "name": "Custom Request", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/client/cart/custom-requests", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "cart", "custom-requests" ] }, "description": "Add custom service request to cart", "body": { "mode": "raw", "raw": "{\n \"description\": \"Custom request description\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📂 Categories", "item": [ { "name": "Category Services", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{client_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/client/categories/:id/services", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "client", "categories", ":id", "services" ] }, "description": "List services under a category" }, "response": [] } ] }, { "name": "📊 System", "item": [ { "name": "🏥 Health", "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/health", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "health" ] }, "description": "**Route:** `shared.health.index`\n**Middleware:** none (public)\n\nLiveness check for the API — returns service status. No authentication required." }, "response": [] } ] }, { "name": "⚙️ Config", "item": [ { "name": "Bootstrap", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/config/bootstrap", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "config", "bootstrap" ] }, "description": "**Route:** `shared.config.bootstrap`\n**Middleware:** none (public)\n\nReturns app bootstrap configuration (feature flags, supported locales, min app version, etc.) consumed by client apps on startup, before login. No authentication required." }, "response": [] } ] } ] } ] }, { "name": "🏢 Company", "description": "## Company Panel\n\nAll company endpoints require `auth:api` + `active` middleware.\n\n### 🔑 Credentials\n| Email | Password | Status |\n|-------|----------|--------|\n| company@info.com | password | ✅ Active |", "item": [ { "name": "🔐 Auth", "item": [ { "name": "Register", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/register", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "register" ] }, "description": "Register new company", "body": { "mode": "raw", "raw": "{\n \"legal_name\": \"New Company LLC\",\n \"email\": \"newcompany@test.com\",\n \"account_owner_phone\": \"+966508888888\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Verify", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "verify" ] }, "description": "Verify company account", "body": { "mode": "raw", "raw": "{\n \"login\": \"newcompany@test.com\",\n \"code\": \"123456\",\n \"token\": \"token-from-register\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Resend Code", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "resend-code" ] }, "description": "Resend verification code", "body": { "mode": "raw", "raw": "{\n \"verification_token\": \"token-from-register\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Login", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/login", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "login" ] }, "description": "Login company account", "body": { "mode": "raw", "raw": "{\n \"login\": \"company@info.com\",\n \"password\": \"password\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "if (jsonData.status === 'success' && jsonData.data && jsonData.data.token) {", " pm.collectionVariables.set('company_token', jsonData.data.token);", " console.log('✅ company_token saved');", "} else {", " console.log('❌ Failed: ' + (jsonData.message || 'Unknown'));", "}" ] } } ] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/logout", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "logout" ] }, "description": "Logout company account" }, "response": [] }, { "name": "Forgot Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/forgot-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "forgot-password" ] }, "description": "Send password reset code", "body": { "mode": "raw", "raw": "{\n \"login\": \"company@info.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reset Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/auth/reset-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "auth", "reset-password" ] }, "description": "Reset password", "body": { "mode": "raw", "raw": "{\n \"login\": \"company@info.com\",\n \"code\": \"123456\",\n \"token\": \"reset-token\",\n \"password\": \"newpass123\",\n \"password_confirmation\": \"newpass123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📄 Content", "item": [ { "name": "FAQs", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/faqs", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "faqs" ] }, "description": "List FAQs" }, "response": [] }, { "name": "About Us", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/static_pages/about_us", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "static_pages", "about_us" ] }, "description": "About Us static page" }, "response": [] }, { "name": "Privacy Policy", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/static_pages/privacy_policies", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "static_pages", "privacy_policies" ] }, "description": "Privacy policy static page" }, "response": [] } ] }, { "name": "👤 Profile", "item": [ { "name": "View Profile", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "profile" ] }, "description": "View company profile with stats" }, "response": [] }, { "name": "Update Profile", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "profile" ] }, "description": "Update company profile", "body": { "mode": "raw", "raw": "{\n \"legal_name\": \"Updated Company\",\n \"tax_number\": \"VAT111111111\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "🏢 Branches", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/branches?search=&is_active=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "branches?search=&is_active=&per_page=15" ] }, "description": "List all branches for this company" }, "response": [] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/branches", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "branches" ] }, "description": "Create a new branch", "body": { "mode": "raw", "raw": "{\n \"name\": \"New Branch\",\n \"address_line\": \"123 King Fahd Road\",\n \"latitude\": 24.7136,\n \"longitude\": 46.6753,\n \"allowed_slots\": [\n \"morning\",\n \"afternoon\"\n ],\n \"contacts\": [\n {\n \"name\": \"Ahmed\",\n \"phone\": \"+966501234567\",\n \"email\": \"ahmed@abc.com\",\n \"is_primary\": true\n }\n ],\n \"working_hours\": [\n {\n \"day\": \"sunday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"monday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"tuesday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"wednesday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"thursday\",\n \"from\": \"09:00\",\n \"to\": \"17:00\"\n },\n {\n \"day\": \"saturday\",\n \"from\": \"09:00\",\n \"to\": \"14:00\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "branches", ":branch" ] }, "description": "Show branch details" }, "response": [] }, { "name": "Update", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "branches", ":branch" ] }, "description": "Update branch", "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Branch\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/branches/:branch", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "branches", ":branch" ] }, "description": "Delete branch" }, "response": [] } ] }, { "name": "📂 Categories", "item": [ { "name": "List Categories", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/categories", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "categories" ] }, "description": "List all service categories" }, "response": [] }, { "name": "Category Services", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/categories/:id/services", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "categories", ":id", "services" ] }, "description": "List services under a category" }, "response": [] } ] }, { "name": "🛒 Cart", "item": [ { "name": "Show Cart", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/cart", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "cart" ] }, "description": "View cart with items and totals" }, "response": [] }, { "name": "Add Item", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/cart/items", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "cart", "items" ] }, "description": "Add service item to cart", "body": { "mode": "raw", "raw": "{\n \"service_id\": 1,\n \"quantity\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Update Item", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/cart/items/:itemId", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "cart", "items", ":itemId" ] }, "description": "Update cart item quantity", "body": { "mode": "raw", "raw": "{\n \"quantity\": 2\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Remove Item", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/cart/items/:itemId", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "cart", "items", ":itemId" ] }, "description": "Remove item from cart" }, "response": [] }, { "name": "Clear Cart", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/cart", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "cart" ] }, "description": "Clear all items from cart" }, "response": [] }, { "name": "Custom Request", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/company/cart/custom-requests", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "cart", "custom-requests" ] }, "description": "Add custom service request to cart", "body": { "mode": "raw", "raw": "{\n \"description\": \"Custom request description\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "🏠 Home", "item": [ { "name": "Dashboard", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/dashboard", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "dashboard" ] }, "description": "Company dashboard overview with stats" }, "response": [] } ] }, { "name": "📋 Contracts", "description": "Company contract management", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts?status=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts" ] }, "description": "List own contracts" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts?status=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts" ] }, "description": "List own contracts" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contracts retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts?status=&per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts" ] }, "description": "List own contracts" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع العقود بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id" ] }, "description": "Show contract details" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id" ] }, "description": "Show contract details" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id" ] }, "description": "Show contract details" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Create", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts" ] }, "description": "Create new contract", "body": { "mode": "raw", "raw": "{\n \"company_id\": 10,\n \"start_date\": \"2026-09-01\",\n \"end_date\": \"2027-08-31\",\n \"billing_cycle\": \"monthly\",\n \"currency\": \"SAR\",\n \"visits_allowed\": 24,\n \"auto_renew\": false,\n \"notes\": \"Annual maintenance contract\",\n \"signed_media_id\": 5,\n \"branches\": [\n {\n \"branch_id\": 1,\n \"service_ids\": [\n 1,\n 2\n ],\n \"visits_allowed\": 12\n },\n {\n \"branch_id\": 2,\n \"service_ids\": [\n 3\n ],\n \"visits_allowed\": 12\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts" ] }, "description": "Create new contract", "body": { "mode": "raw", "raw": "{\n \"service_ids\": [\n 1\n ],\n \"branch_ids\": [\n 1\n ],\n \"start_date\": \"2026-09-01\",\n \"end_date\": \"2027-08-31\",\n \"billing_cycle\": \"monthly\",\n \"visits_allowed\": 12,\n \"total_amount\": 12000\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract created successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts" ] }, "description": "Create new contract", "body": { "mode": "raw", "raw": "{\n \"service_ids\": [\n 1\n ],\n \"branch_ids\": [\n 1\n ],\n \"start_date\": \"2026-09-01\",\n \"end_date\": \"2027-08-31\",\n \"billing_cycle\": \"monthly\",\n \"visits_allowed\": 12,\n \"total_amount\": 12000\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم إنشاء العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id" ] }, "description": "Delete draft contract" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id" ] }, "description": "Delete draft contract" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract deleted successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id" ] }, "description": "Delete draft contract" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم حذف العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Download Template", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/template", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "template" ] }, "description": "Download template PDF" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/template", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "template" ] }, "description": "Download template PDF" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Template retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/template", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "template" ] }, "description": "Download template PDF" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع النموذج بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Sign", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/sign", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "sign" ] }, "description": "Upload signed PDF -> pending_approval", "body": { "mode": "raw", "raw": "{\n \"signed_media_id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/sign", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "sign" ] }, "description": "Upload signed PDF -> pending_approval", "body": { "mode": "raw", "raw": "{\n \"signed_media_id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Contract signed successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/sign", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "sign" ] }, "description": "Upload signed PDF -> pending_approval", "body": { "mode": "raw", "raw": "{\n \"signed_media_id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم توقيع العقد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "Request Renewal", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/renew", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "renew" ] }, "description": "Request renewal", "body": { "mode": "raw", "raw": "{\n \"note\": \"Renew for another year\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/renew", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "renew" ] }, "description": "Request renewal", "body": { "mode": "raw", "raw": "{\n \"note\": \"Renew for another year\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Renewal request submitted successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/renew", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "renew" ] }, "description": "Request renewal", "body": { "mode": "raw", "raw": "{\n \"note\": \"Renew for another year\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم إرسال طلب التجديد بنجاح.\",\n \"data\": {}\n}" } ] }, { "name": "View Ledger", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/ledger", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "ledger" ] }, "description": "View visit ledger" }, "response": [ { "name": "Success (EN)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/ledger", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "ledger" ] }, "description": "View visit ledger" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"Visit ledger retrieved successfully.\",\n \"data\": {}\n}" }, { "name": "Success (AR)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/company/contracts/:id/ledger", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "company", "contracts", ":id", "ledger" ] }, "description": "View visit ledger" }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"message\": \"تم استرجاع سجل الزيارات بنجاح.\",\n \"data\": {}\n}" } ] } ] }, { "name": "📊 System", "item": [ { "name": "🏥 Health", "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/health", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "health" ] }, "description": "**Route:** `shared.health.index`\n**Middleware:** none (public)\n\nLiveness check for the API — returns service status. No authentication required." }, "response": [] } ] }, { "name": "⚙️ Config", "item": [ { "name": "Bootstrap", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/config/bootstrap", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "config", "bootstrap" ] }, "description": "**Route:** `shared.config.bootstrap`\n**Middleware:** none (public)\n\nReturns app bootstrap configuration (feature flags, supported locales, min app version, etc.) consumed by client apps on startup, before login. No authentication required." }, "response": [] } ] } ] }, { "name": "🔔 Notifications", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.notifications.index`\n**Middleware:** `auth:api, active`\n\nList the authenticated user's notifications, newest first." }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.show`\n**Middleware:** `auth:api, active`\n\nShow a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.destroy`\n**Middleware:** `auth:api, active`\n\nDelete a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Mark All Read", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/mark-all-read", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "mark-all-read" ] }, "description": "**Route:** `shared.notifications.mark-all-read`\n**Middleware:** `auth:api, active`\n\nMarks every unread notification for the authenticated user as read. No request body." }, "response": [] }, { "name": "Clear All", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/clear-all", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "clear-all" ] }, "description": "**Route:** `shared.notifications.clear-all`\n**Middleware:** `auth:api, active`\n\nDeletes every notification for the authenticated user. No request body." }, "response": [] } ] }, { "name": "📸 Media", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/media?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "media" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.media.index`\n**Middleware:** `auth:api, active`\n\nList media uploaded by the authenticated user. Cross-role endpoint — reachable by any authenticated user type." }, "response": [] }, { "name": "Upload", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/media", "host": [ "{{base_url}}" ], "path": [ "media" ] }, "description": "**Route:** `shared.media.store`\n**Middleware:** `auth:api, active`\n\nSend as `multipart/form-data`. Returns the created media record, whose `id`/`hash` is used by other endpoints that reference an uploaded file (e.g. profile `image`, ID scans).\n\n**Fields:**\n- `file` (file, required) — the file to upload. Max 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav.\n- `collection` (string, optional) — logical bucket to group the upload under (e.g. avatars, id_scans, cv).", "body": { "mode": "formdata", "formdata": [ { "key": "file", "type": "file", "src": "", "description": "Type: file | Required: required\nRules: required|file|max:10240|mimes:jpg,jpeg,png,gif,webp,pdf,avi,mov,wmv,flv,mkv,mp4,mp3,wav\nMax size 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav." }, { "key": "collection", "type": "text", "value": "avatars", "description": "Type: string | Required: optional\nRules: nullable|string|max:255\nLogical bucket to group the upload under (e.g. avatars, id_scans, cv)." } ] } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{company_token}}" } ], "url": { "raw": "{{base_url}}/media/:media_id", "host": [ "{{base_url}}" ], "path": [ "media", ":media_id" ] }, "description": "**Route:** `shared.media.destroy`\n**Middleware:** `auth:api, active`\n\nDeletes a media record by id. Only the uploader (or an admin) may delete it." }, "response": [] } ] } ] }, { "name": "🔧 Technician", "description": "## Technician App\n\nAll technician endpoints require `auth:api` + `active` middleware.\n\n### 🔑 Credentials\n| Email | Password | Status |\n|-------|----------|--------|\n| technician@info.com | password | ✅ Active |", "item": [ { "name": "🔐 Auth", "item": [ { "name": "Register", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/register", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "register" ] }, "description": "### Register new technician\n\n**3-step registration flow:**\n1. Personal Data\n2. Professional Data (category_id + shipping_zone_ids)\n3. Attachments\n\n**Required fields:**\n- `full_name`, `email`, `phone`, `password`, `category_id`\n\n**category_id:** Service category ID from GET /admin/categories\n**shipping_zone_ids:** Array of shipping zone IDs from GET /admin/shipping-zones", "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Ahmed Mohammed\",\n \"email\": \"ahmed@example.com\",\n \"phone\": \"+966501234567\",\n \"phone_code\": \"+966\",\n \"id_number\": \"1234567890\",\n \"city\": \"Riyadh\",\n \"district\": \"Al Olaya\",\n \"address\": \"123 Main Street\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\",\n\n \"category_id\": 1,\n \"shipping_zone_ids\": [1, 2, 3],\n \"years_experience\": 5,\n \"daily_order_capacity\": 10,\n\n \"personal_photo\": 1,\n \"national_id_front\": 2,\n \"national_id_back\": 3,\n \"cv_file\": 4,\n\n \"device_id\": \"device-123\",\n \"device_token\": \"fcm-token-xxx\",\n \"device_type\": \"android\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Verify", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/verify", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "verify" ] }, "description": "Verify technician account", "body": { "mode": "raw", "raw": "{\n \"login\": \"newtech@test.com\",\n \"code\": \"123456\",\n \"token\": \"token-from-register\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Resend Code", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "resend-code" ] }, "description": "Resend verification code", "body": { "mode": "raw", "raw": "{\n \"verification_token\": \"token-from-register\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Login", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/login", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "login" ] }, "description": "Login technician account", "body": { "mode": "raw", "raw": "{\n \"login\": \"technician@info.com\",\n \"password\": \"password\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "if (jsonData.status === 'success' && jsonData.data && jsonData.data.token) {", " pm.collectionVariables.set('technician_token', jsonData.data.token);", " console.log('✅ technician_token saved');", "} else {", " console.log('❌ Failed: ' + (jsonData.message || 'Unknown'));", "}" ] } } ] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/logout", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "logout" ] }, "description": "Logout technician account" }, "response": [] }, { "name": "Forgot Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/forgot-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "forgot-password" ] }, "description": "Send password reset code", "body": { "mode": "raw", "raw": "{\n \"login\": \"technician@info.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reset Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/v1/technician/auth/reset-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "auth", "reset-password" ] }, "description": "Reset password", "body": { "mode": "raw", "raw": "{\n \"login\": \"technician@info.com\",\n \"code\": \"123456\",\n \"token\": \"reset-token\",\n \"password\": \"newpass123\",\n \"password_confirmation\": \"newpass123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📄 Content", "item": [ { "name": "FAQs", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/faqs", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "faqs" ] }, "description": "List FAQs" }, "response": [] }, { "name": "About Us", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/static_pages/about_us", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "static_pages", "about_us" ] }, "description": "About Us static page" }, "response": [] }, { "name": "Privacy Policy", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/static_pages/privacy_policies", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "static_pages", "privacy_policies" ] }, "description": "Privacy policy static page" }, "response": [] } ] }, { "name": "👤 Profile", "item": [ { "name": "View Profile", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "profile" ] }, "description": "View technician profile with stats (rating, completed orders, availability)" }, "response": [] }, { "name": "Update Profile", "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/profile", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "profile" ] }, "description": "Update technician profile", "body": { "mode": "raw", "raw": "{\n \"name\": \"Ahmed Updated\",\n \"full_name\": \"Ahmed Mohammed Updated\",\n \"city\": \"Jeddah\",\n \"category_id\": 2,\n \"coverage_areas\": [1, 3],\n \"years_experience\": 6,\n \"daily_order_capacity\": 8\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Change Password", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/profile/change-password", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "profile", "change-password" ] }, "description": "Change technician password", "body": { "mode": "raw", "raw": "{\n \"current_password\": \"password123\",\n \"password\": \"newpassword123\",\n \"password_confirmation\": \"newpassword123\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Toggle Availability", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/profile/toggle-availability", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "profile", "toggle-availability" ] }, "description": "Toggle availability between available and unavailable" }, "response": [] } ] }, { "name": "💰 Wallet", "item": [ { "name": "Balance", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/wallet", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "wallet" ] }, "description": "Get technician wallet balance. Returns can_withdraw: true for technicians." }, "response": [] }, { "name": "Transactions", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/wallet/transactions?type=&status=&from_date=&to_date=&per_page=20", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "wallet", "transactions" ], "query": [ { "key": "type", "value": "", "description": "Filter: refund_credit, order_debit, reversal" }, { "key": "status", "value": "", "description": "Filter: pending, completed, failed" }, { "key": "from_date", "value": "", "description": "Start date (YYYY-MM-DD)" }, { "key": "to_date", "value": "", "description": "End date (YYYY-MM-DD)" }, { "key": "per_page", "value": "20", "description": "Results per page (1-50)" } ] }, "description": "List wallet transactions with filtering" }, "response": [] }, { "name": "Withdraw", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/technician/wallet/withdraw", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "technician", "wallet", "withdraw" ] }, "description": "Submit withdrawal request. Technicians can withdraw; individuals cannot (BR-07).", "body": { "mode": "raw", "raw": "{\n \"amount\": 500,\n \"bank_name\": \"Al Rajhi Bank\",\n \"account_number\": \"1234567890\",\n \"iban\": \"SA1234567890123456789012\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "📊 System", "item": [ { "name": "🏥 Health", "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/health", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "health" ] }, "description": "**Route:** `shared.health.index`\n**Middleware:** none (public)\n\nLiveness check for the API — returns service status. No authentication required." }, "response": [] } ] }, { "name": "⚙️ Config", "item": [ { "name": "Bootstrap", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" } ], "url": { "raw": "{{base_url}}/api/v1/config/bootstrap", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "config", "bootstrap" ] }, "description": "**Route:** `shared.config.bootstrap`\n**Middleware:** none (public)\n\nReturns app bootstrap configuration (feature flags, supported locales, min app version, etc.) consumed by client apps on startup, before login. No authentication required." }, "response": [] } ] } ] }, { "name": "🔔 Notifications", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.notifications.index`\n**Middleware:** `auth:api, active`\n\nList the authenticated user's notifications, newest first." }, "response": [] }, { "name": "Show", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.show`\n**Middleware:** `auth:api, active`\n\nShow a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/:id", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", ":id" ] }, "description": "**Route:** `shared.notifications.destroy`\n**Middleware:** `auth:api, active`\n\nDelete a single notification belonging to the authenticated user." }, "response": [] }, { "name": "Mark All Read", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/mark-all-read", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "mark-all-read" ] }, "description": "**Route:** `shared.notifications.mark-all-read`\n**Middleware:** `auth:api, active`\n\nMarks every unread notification for the authenticated user as read. No request body." }, "response": [] }, { "name": "Clear All", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/api/v1/notifications/clear-all", "host": [ "{{base_url}}" ], "path": [ "api", "v1", "notifications", "clear-all" ] }, "description": "**Route:** `shared.notifications.clear-all`\n**Middleware:** `auth:api, active`\n\nDeletes every notification for the authenticated user. No request body." }, "response": [] } ] }, { "name": "📸 Media", "item": [ { "name": "List All", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/media?page=1&per_page=15&sort[created_at]=desc&paginate=false", "host": [ "{{base_url}}" ], "path": [ "media" ], "query": [ { "key": "page", "value": "1", "description": "Page number", "disabled": false }, { "key": "per_page", "value": "15", "description": "Items per page (max: 100)", "disabled": true }, { "key": "sort[created_at]", "value": "desc", "description": "Sort by field: asc or desc", "disabled": true }, { "key": "paginate", "value": "false", "description": "Set to false to disable pagination", "disabled": true } ] }, "description": "**Route:** `shared.media.index`\n**Middleware:** `auth:api, active`\n\nList media uploaded by the authenticated user. Cross-role endpoint — reachable by any authenticated user type." }, "response": [] }, { "name": "Upload", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/media", "host": [ "{{base_url}}" ], "path": [ "media" ] }, "description": "**Route:** `shared.media.store`\n**Middleware:** `auth:api, active`\n\nSend as `multipart/form-data`. Returns the created media record, whose `id`/`hash` is used by other endpoints that reference an uploaded file (e.g. profile `image`, ID scans).\n\n**Fields:**\n- `file` (file, required) — the file to upload. Max 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav.\n- `collection` (string, optional) — logical bucket to group the upload under (e.g. avatars, id_scans, cv).", "body": { "mode": "formdata", "formdata": [ { "key": "file", "type": "file", "src": "", "description": "Type: file | Required: required\nRules: required|file|max:10240|mimes:jpg,jpeg,png,gif,webp,pdf,avi,mov,wmv,flv,mkv,mp4,mp3,wav\nMax size 10MB. Allowed: jpg, jpeg, png, gif, webp, pdf, avi, mov, wmv, flv, mkv, mp4, mp3, wav." }, { "key": "collection", "type": "text", "value": "avatars", "description": "Type: string | Required: optional\nRules: nullable|string|max:255\nLogical bucket to group the upload under (e.g. avatars, id_scans, cv)." } ] } }, "response": [] }, { "name": "Delete", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Accept-Language", "value": "{{locale}}" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{technician_token}}" } ], "url": { "raw": "{{base_url}}/media/:media_id", "host": [ "{{base_url}}" ], "path": [ "media", ":media_id" ] }, "description": "**Route:** `shared.media.destroy`\n**Middleware:** `auth:api, active`\n\nDeletes a media record by id. Only the uploader (or an admin) may delete it." }, "response": [] } ] } ] } ] }