{ "info": { "name": "SafeHouse API - BusinessController (Final)", "_postman_id": "8b9b1f3a-6c5f-4c79-9a2b-0bd7b0f2d004", "description": "Postman collection for BusinessController testing on https://localhost:7247 based on actual implementation", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/health", "description": "Health check endpoint - returns active businesses count" } }, { "name": "Get User Businesses", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/user/USER123?includeInactive=false", "description": "Get all businesses for a specific user" } }, { "name": "Get Business By ID", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345", "description": "Get detailed business information by business ID" } }, { "name": "Create Business - Restaurant", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"userId\": \"USER123\",\n \"facilityId\": \"FAC_KIAMBU_001\",\n \"businessName\": \"Mama Jane's Kitchen\",\n \"businessDescription\": \"Authentic Kenyan home-cooked meals with fresh ingredients from local farmers. Specializing in traditional dishes and modern fusion cuisine.\",\n \"businessType\": \"Restaurant\",\n \"categoryId\": \"CAT_RESTAURANT\",\n \"subcategoryId\": \"SUBCAT_LOCAL_CUISINE\",\n \"yearsInBusiness\": 5,\n \"employeeCount\": 8,\n \"serviceRadiusKm\": 5.0,\n \"minPrice\": 200.0,\n \"maxPrice\": 1500.0,\n \"currency\": \"KSh\",\n \"contactPhone\": \"+254712345678\",\n \"contactEmail\": \"orders@mamajaneskitchen.co.ke\",\n \"websiteUrl\": \"https://mamajaneskitchen.co.ke\",\n \"address\": \"Shop 15, Ground Floor, Kiambu Plaza\",\n \"latitude\": -1.1719,\n \"longitude\": 36.8356,\n \"suburb\": \"Kiambu Town\",\n \"city\": \"Kiambu\",\n \"county\": \"Kiambu County\",\n \"state\": \"Kiambu\",\n \"availabilityStatus\": \"Available\",\n \"isVerifiedBusiness\": false,\n \"isActive\": true,\n \"deliveryAvailable\": true,\n \"pickupAvailable\": true,\n \"onsiteAvailable\": true,\n \"onlineOrderingAvailable\": true,\n \"requiresAppointment\": false,\n \"advanceBookingHours\": 2,\n \"businessTags\": [\"kenyan food\", \"home cooking\", \"fresh ingredients\", \"local cuisine\"],\n \"socialMedia\": {\n \"facebook\": \"https://facebook.com/MamaJanesKitchenKE\",\n \"instagram\": \"@mamajaneskitchen\",\n \"x\": \"@MamaJanesKE\",\n \"whatsapp\": \"+254712345678\"\n },\n \"paymentMethods\": [\"Cash\", \"Mpesa\", \"Card\"]\n}" }, "url": "https://localhost:7247/api/business", "description": "Create a new restaurant business with comprehensive details" } }, { "name": "Create Business - Grocery Store", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"userId\": \"USER124\",\n \"facilityId\": \"FAC_KIAMBU_001\",\n \"businessName\": \"Fresh Valley Groceries\",\n \"businessDescription\": \"Your neighborhood grocery store offering fresh produce, household items, and daily essentials at affordable prices.\",\n \"businessType\": \"Retail\",\n \"categoryId\": null,\n \"subcategoryId\": null,\n \"yearsInBusiness\": 3,\n \"employeeCount\": 12,\n \"serviceRadiusKm\": 3.0,\n \"minPrice\": 10.0,\n \"maxPrice\": 5000.0,\n \"currency\": \"KSh\",\n \"contactPhone\": \"+254722987654\",\n \"contactEmail\": \"info@freshvalley.co.ke\",\n \"websiteUrl\": \"https://freshvalley.co.ke\",\n \"address\": \"Building C, Unit 8, Kiambu Gardens\",\n \"latitude\": -1.1745,\n \"longitude\": 36.8389,\n \"suburb\": \"Kiambu Gardens\",\n \"city\": \"Kiambu\",\n \"county\": \"Kiambu County\",\n \"state\": \"Kiambu\",\n \"availabilityStatus\": \"Available\",\n \"isVerifiedBusiness\": false,\n \"isActive\": true,\n \"deliveryAvailable\": true,\n \"pickupAvailable\": true,\n \"onsiteAvailable\": true,\n \"onlineOrderingAvailable\": true,\n \"requiresAppointment\": false,\n \"advanceBookingHours\": 1,\n \"businessTags\": [\"groceries\", \"fresh produce\", \"household items\", \"daily essentials\"],\n \"socialMedia\": {\n \"facebook\": \"https://facebook.com/FreshValleyKE\",\n \"instagram\": \"@freshvalleyke\",\n \"whatsapp\": \"+254722987654\"\n },\n \"paymentMethods\": {\n \"Cash\": true,\n \"Mpesa\": true,\n \"Bank Transfer\": false,\n \"Card\": false\n }\n}" }, "url": "https://localhost:7247/api/business", "description": "Create a new grocery store business" } }, { "name": "Create Business - Repair Service", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"userId\": \"USER125\",\n \"facilityId\": \"FAC_KIAMBU_001\",\n \"businessName\": \"TechFix Solutions\",\n \"businessDescription\": \"Professional electronics and appliance repair services. We fix phones, laptops, TVs, and home appliances with quality parts and expert technicians.\",\n \"businessType\": \"Service\",\n \"categoryId\": \"CAT_REPAIR\",\n \"subcategoryId\": \"SUBCAT_ELECTRONICS\",\n \"yearsInBusiness\": 7,\n \"employeeCount\": 6,\n \"serviceRadiusKm\": 10.0,\n \"minPrice\": 500.0,\n \"maxPrice\": 15000.0,\n \"currency\": \"KSh\",\n \"contactPhone\": \"+254733456789\",\n \"contactEmail\": \"repairs@techfixsolutions.co.ke\",\n \"websiteUrl\": \"https://techfixsolutions.co.ke\",\n \"address\": \"Workshop 12, Kiambu Technical Center\",\n \"latitude\": -1.1699,\n \"longitude\": 36.8401,\n \"suburb\": \"Industrial Area\",\n \"city\": \"Kiambu\",\n \"county\": \"Kiambu County\",\n \"state\": \"Kiambu\",\n \"availabilityStatus\": \"Available\",\n \"isVerifiedBusiness\": false,\n \"isActive\": true,\n \"deliveryAvailable\": true,\n \"pickupAvailable\": true,\n \"onsiteAvailable\": true,\n \"onlineOrderingAvailable\": false,\n \"requiresAppointment\": true,\n \"advanceBookingHours\": 24,\n \"businessTags\": [\"electronics repair\", \"phone repair\", \"laptop repair\", \"appliance repair\"],\n \"socialMedia\": {\n \"facebook\": \"https://facebook.com/TechFixSolutionsKE\",\n \"instagram\": \"@techfixsolutions\",\n \"x\": \"@TechFixKE\"\n },\n \"paymentMethods\": [\"Cash\", \"Mpesa\", \"Bank Transfer\"]\n}" }, "url": "https://localhost:7247/api/business", "description": "Create a new repair service business" } }, { "name": "Update Business", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"businessName\": \"Mama Jane's Kitchen & Catering\",\n \"businessDescription\": \"Authentic Kenyan home-cooked meals with fresh ingredients from local farmers. Now offering catering services for events and parties.\",\n \"contactPhone\": \"+254712345678\",\n \"contactEmail\": \"info@mamajaneskitchen.co.ke\",\n \"serviceRadiusKm\": 7.0,\n \"minPrice\": 250.0,\n \"maxPrice\": 2000.0,\n \"deliveryAvailable\": true,\n \"pickupAvailable\": true,\n \"onlineOrderingAvailable\": true,\n \"isActive\": true,\n \"socialMedia\": {\n \"facebook\": \"https://facebook.com/MamaJanesKitchenKE\",\n \"instagram\": \"@mamajaneskitchen\",\n \"x\": \"@MamaJanesKE\",\n \"whatsapp\": \"+254712345678\",\n \"tiktok\": \"@mamajaneskitchen\"\n },\n \"businessTags\": [\"kenyan food\", \"home cooking\", \"fresh ingredients\", \"local cuisine\", \"catering\"]\n}" }, "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345", "description": "Update existing business profile information" } }, { "name": "Search Businesses", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/search?query=restaurant&facilityId=FAC_KIAMBU_001&categoryId=CAT_RESTAURANT&latitude=-1.1719&longitude=36.8356&radiusKm=5&page=1&pageSize=10", "description": "Search businesses with filters" } }, { "name": "Get Businesses by Location", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/location?latitude=-1.1719&longitude=36.8356&radiusKm=5&categoryId=CAT_RESTAURANT&page=1&pageSize=20", "description": "Get businesses within specified radius" } }, { "name": "Get Featured Businesses", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/featured?latitude=-1.1719&longitude=36.8356&radiusKm=10&limit=12", "description": "Get featured businesses for homepage" } }, { "name": "Get Businesses by Category", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/category/CAT_RESTAURANT?facilityId=FAC_KIAMBU_001&page=1&pageSize=20", "description": "Get all businesses in a specific category" } }, { "name": "Get Businesses by Facility", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/facility/FAC_KIAMBU_001?page=1&pageSize=20&categoryId=all&status=Active", "description": "Get all businesses in a specific facility" } }, { "name": "Add Business Service", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"serviceName\": \"Catering Services\",\n \"serviceDescription\": \"Professional catering for events, parties, and corporate functions. Minimum 10 people.\",\n \"servicePrice\": 800.0,\n \"currency\": \"KSh\",\n \"priceType\": \"per_person\",\n \"serviceCategory\": \"Catering\",\n \"duration\": 240,\n \"isActive\": true,\n \"requiresBooking\": true,\n \"advanceBookingHours\": 48,\n \"maxCapacity\": 200,\n \"serviceFeatures\": [\"Setup\", \"Cleanup\", \"Serving Staff\", \"Decorations\"],\n \"serviceIncludes\": [\"Food\", \"Drinks\", \"Plates\", \"Cutlery\", \"Napkins\"]\n}" }, "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/services", "description": "Add a new service to an existing business" } }, { "name": "Get Business Services", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/services?includeInactive=false", "description": "Get all services offered by a business" } }, { "name": "Add Business Review", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reviewerId\": \"USER456\",\n \"reviewerName\": \"John Mwangi\",\n \"rating\": 5,\n \"reviewTitle\": \"Excellent Food and Service!\",\n \"reviewText\": \"Had an amazing experience at Mama Jane's Kitchen. The ugali was perfectly cooked and the nyama choma was tender and flavorful. Service was quick and the staff were very friendly. Will definitely be back!\",\n \"serviceExperience\": \"Outstanding\",\n \"foodQuality\": 5,\n \"serviceRating\": 5,\n \"valueForMoney\": 5,\n \"cleanliness\": 5,\n \"recommendToFriends\": true,\n \"visitDate\": \"2024-09-08\",\n \"orderType\": \"Dine-in\"\n}" }, "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/reviews", "description": "Add a customer review for a business" } }, { "name": "Get Business Reviews", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/reviews?page=1&pageSize=10&sortBy=newest", "description": "Get customer reviews for a business" } }, { "name": "Get Business Analytics", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/analytics?startDate=2024-01-01&endDate=2024-12-31", "description": "Get business analytics and performance metrics" } }, { "name": "Upload Business Images", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"images\": [\n {\n \"imageType\": \"logo\",\n \"imageBase64\": \"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD//gA7Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2ODApLCBxdWFsaXR5ID0gODAK/9sAQwAGBAUGBQQGBgUGBwcGCAoQCgoJCQoUDg8MEBcUGBgXFBcUGh0dHBseHBcXGh4fISAgIh8dJCcnJy4uLjg+Oj8+/9sAQwEHBwcLCgwSDAwSPh0dHj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+/8AAEQgAZABkAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBkQgUobHwFcHR4fEjJTQgJkNicsEVkw==\",\n \"fileName\": \"restaurant-logo.jpg\",\n \"isPrimary\": true,\n \"displayOrder\": 1\n },\n {\n \"imageType\": \"storefront\",\n \"imageBase64\": \"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD//gA7Q1JFQVRPUjogZ2QtanBlZyB2MS4wICh1c2luZyBJSkcgSlBFRyB2ODApLCBxdWFsaXR5ID0gODAK/9sAQwAGBAUGBQQGBgUGBwcGCAoQCgoJCQoUDg8MEBcUGBgXFBcUGh0dHBseHBcXGh4fISAgIh8dJCcnJy4uLjg+Oj8+/9sAQwEHBwcLCgwSDAwSPh0dHj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+Pj4+/8AAEQgAZABkAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBkQgUobHwFcHR4fEjJTQgJkNicsEVkw==\",\n \"fileName\": \"storefront.jpg\",\n \"isPrimary\": false,\n \"displayOrder\": 2\n }\n ]\n}" }, "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/images", "description": "Upload business images (logo, storefront, etc.)" } }, { "name": "Submit Business for Verification", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"verificationType\": \"facility\",\n \"verificationDocuments\": [\n {\n \"documentType\": \"business_license\",\n \"documentNumber\": \"BL/2024/KIAMBU/001234\",\n \"documentBase64\": \"data:application/pdf;base64,JVBERi0xLjQKJeLjz9MKMSAwIG9iak==...\",\n \"fileName\": \"business-license.pdf\"\n },\n {\n \"documentType\": \"tax_pin\",\n \"documentNumber\": \"P051234567X\",\n \"documentBase64\": \"data:application/pdf;base64,JVBERi0xLjQKJeLjz9MKMSAwIG9iak==...\",\n \"fileName\": \"kra-pin-certificate.pdf\"\n }\n ],\n \"verificationNotes\": \"All documents are current and valid. Business operates within facility guidelines.\"\n}" }, "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/verify", "description": "Submit business for verification with documents" } }, { "name": "Get Verification Status", "request": { "method": "GET", "header": [], "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345/verification", "description": "Get current verification status and history" } }, { "name": "Delete Business", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"Business permanently closed\",\n \"confirmDelete\": true\n}" }, "url": "https://localhost:7247/api/business/BIZ_20240909123456_ABC12345", "description": "Permanently delete a business" } } ] }