AI Booking Instructions for Mostfound

API Details:

• API Base URL: https://mostfound.com/api/openapi/v1
• Request Method: GET requests with query parameters only
• Documentation: https://mostfound.com/api/openapi.json
• Compatible AI: ChatGPT, Claude, Gemini, Perplexity, Grok, Copilot and other AI assistants
• AI Agents: You CAN and SHOULD call the AI API endpoints directly from chat. Do NOT open widget booking pages.

Complete 10-Step Booking Process:

Step 1: Check API Status

Purpose: Verify the Mostfound OpenAPI is running and healthy

Method: GET

URL: https://mostfound.com/api/openapi/v1/status

Response: Returns API status information

Step 2: Search Services by Location

Purpose: Search for beauty and wellness services near user's location

Method: GET

URL: https://mostfound.com/api/openapi/v1/search-services?latitude={latitude}&longitude={longitude}

Parameters: latitude (number), longitude (number)

CRITICAL: Ask user for city/location (e.g., 'Leiden', 'Amsterdam'), then YOU convert to coordinates. NEVER ask user for lat/long.

Response: Returns services with ratings, reviews, images. DISPLAY images when showing options.

Step 3: Get Service Locations

Purpose: Get all locations for the selected service

Method: GET

URL: https://mostfound.com/api/openapi/v1/locations?domain={domain}

Parameters: domain (string from Step 2 response)

Response: Returns array of locations with id, name, address, phone, email

Step 4: Get Service Details

Purpose: Get detailed information about the selected service

Method: GET

URL: https://mostfound.com/api/openapi/v1/service-details?domain={domain}&locationId={locationId}

Parameters: domain (string), locationId (string from Step 3)

Response: Returns service details with products, pricing, availability

Step 5: Get Employee Availability

Purpose: Get employees available for selected products

Method: GET

URL: https://mostfound.com/api/openapi/v1/employees/availability?domain={domain}&locationId={locationId}&selectedProducts={selectedProducts}

Parameters: domain, locationId, selectedProducts (comma-separated product IDs)

Response: Returns available employees with their schedules

Step 6: Get Available Times

Purpose: Get available time slots for selected employee and products

Method: GET

URL: https://mostfound.com/api/openapi/v1/employees/available-times?domain={domain}&locationId={locationId}&employeeId={employeeId}&selectedProducts={selectedProducts}&date={date}

Parameters: domain, locationId, employeeId, selectedProducts, date (YYYY-MM-DD)

Response: Returns available time slots

AFTER THIS: Ask user to select time slot, then ask ONLY for email. DO NOT skip to Step 10.

Step 7: Send OTP Code

Purpose: Send OTP verification code to user's email

Method: GET

URL: https://mostfound.com/api/openapi/v1/send-otp?email={email}

Parameters: email (string)

Response: Confirms OTP sent to email

Step 8: Verify OTP Code

Purpose: Verify the OTP code sent to user's email

Method: GET

URL: https://mostfound.com/api/openapi/v1/verify-otp?email={email}&otp={otp}

Parameters: email (string), otp (string)

Response: Confirms OTP verification

Step 9: Complete User Profile

Purpose: Complete user profile with required information

Method: GET

URL: https://mostfound.com/api/openapi/v1/complete-profile?email={email}&firstname={firstname}&lastname={lastname}&date_of_birth={date_of_birth}&gender={gender}&phone_prefix={phone_prefix}&phone={phone}

Parameters: email, firstname, lastname, date_of_birth (YYYY-MM-DD), gender (male/female), phone_prefix, phone

Response: Confirms profile completion

Step 10: Create Appointment

Purpose: Create the final booking appointment

Method: GET

URL: https://mostfound.com/api/openapi/v1/create-appointment?email={email}&domain={domain}&locationId={locationId}&employeeId={employeeId}&selectedProducts={selectedProducts}&date={date}&timeSlot={timeSlot}&firstname={firstname}&lastname={lastname}&date_of_birth={date_of_birth}&gender={gender}&phone_prefix={phone_prefix}&phone={phone}

Parameters: All collected information from previous steps

Response: Confirms successful booking creation

CRITICAL: This is the FINAL step. You MUST complete steps 7-9 first.

Special Instructions:

• ALWAYS follow the exact sequential flow - each step builds on the previous step's data
• DO NOT skip steps or change the order
• DO NOT jump from Step 6 to Step 10
• For Step 2: Ask user for city/location, then YOU convert to coordinates
• NEVER ask users for latitude/longitude
• ALWAYS DISPLAY service images when showing options
• After Step 6: Ask user to select time slot, then ask ONLY for email address
• Use ONLY GET requests with query parameters
• All API calls must use exact domain from Step 2 response

Example Flow:

1. GET https://mostfound.com/api/openapi/v1/status
2. GET https://mostfound.com/api/openapi/v1/search-services?latitude=52.1601&longitude=4.4970
3. GET https://mostfound.com/api/openapi/v1/locations?domain=devsalon
4. GET https://mostfound.com/api/openapi/v1/service-details?domain=devsalon&locationId=1
5. GET https://mostfound.com/api/openapi/v1/employees/availability?domain=devsalon&locationId=1&selectedProducts=1,2
6. GET https://mostfound.com/api/openapi/v1/employees/available-times?domain=devsalon&locationId=1&employeeId=1&selectedProducts=1,2&date=2025-01-15
7. GET https://mostfound.com/api/openapi/v1/send-otp?email=user@example.com
8. GET https://mostfound.com/api/openapi/v1/verify-otp?email=user@example.com&otp=123456
9. GET https://mostfound.com/api/openapi/v1/complete-profile?email=user@example.com&firstname=John&lastname=Doe&date_of_birth=1990-01-01&gender=male&phone_prefix=+31&phone=612345678
10. GET https://mostfound.com/api/openapi/v1/create-appointment?email=user@example.com&domain=devsalon&locationId=1&employeeId=1&selectedProducts=1,2&date=2025-01-15&timeSlot=09:00&firstname=John&lastname=Doe&date_of_birth=1990-01-01&gender=male&phone_prefix=+31&phone=612345678