Developer API Docs

Dynamic interactive API references parsed directly from the system Postman collection.

Download Postman Collection
API Sections

POST

Register

Customer • Auth
{{base_url}}/api/customer/register
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "full_name": "John Doe",
  "email": "john@example.com",
  "phone": "0501234567",
  "password": "password123"
}
POST

Login

Customer • Auth
{{base_url}}/api/customer/login
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "email": "john@example.com",
  "password": "password123"
}
GET

Profile

Customer • Auth
{{base_url}}/api/customer/profile
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Forgot Password

Customer • Auth
{{base_url}}/api/customer/forgot-password
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
JSON Request Body
{
  "email": "john@example.com"
}
POST

Reset Password

Customer • Auth
{{base_url}}/api/customer/reset-password
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
JSON Request Body
{
  "token": "mock_reset_token_here",
  "password": "newpassword123"
}
POST

Change Password

Customer • Auth
{{base_url}}/api/customer/change-password
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "old_password": "password123",
  "new_password": "newpassword123"
}
POST

Update Profile

Customer • Auth
{{base_url}}/api/customer/profile/update
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "full_name": "Johnathan Doe",
  "phone_code": "+971",
  "phone": "0509999999",
  "preferred_language": "ar",
  "city_ids": [1, 2]
}
POST

Create Quotation Request

Customer • Quotation Requests
{{base_url}}/api/customer/quotation-requests/create
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
    "vendor_id": 1,
    "request_type": "general_vendor",
    "number_of_helpers": 1,
    "preferred_nationality_id": 1,
    "specialty_ids": [
        4
    ],
    "service_model_id": 1,
    "additional_notes": "We need the helper to start early in the morning and have experience in cooking Filipino food."
}
GET

List Quotation Requests

Customer • Quotation Requests
{{base_url}}/api/customer/quotation-requests
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Cancel Quotation Request

Customer • Quotation Requests
{{base_url}}/api/customer/quotation-requests/1/cancel
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Quotation Request Details

Customer • Quotation Requests
{{base_url}}/api/customer/quotation-requests/1
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Create Specific Maid Request

Customer • Quotation Requests
{{base_url}}/api/customer/quotation-requests/create
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
    "vendor_id": 1,
    "maid_id": 4,
    "request_type": "specific_maid",
    "start_date": "2024-10-15",
    "duration_months": 6,
    "work_days": 6,
    "service_model_id": 2,
    "specialty_ids": [
        5,
        6,
        4
    ],
    "city_id": 1,
    "additional_notes": "E.g., Gate code is 1234, please park in visitor area...",
    "estimated_total_value": 15000,
    "estimated_monthly_payment": 2500
}
POST

Create Interview

Customer • Interviews
{{base_url}}/api/customer/interviews/create
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "vendor_id": 1,
  "maid_id": 4,
  "platform_id": 1,
  "interview_date": "2024-10-14",
  "time_from": "10:00:00",
  "time_to": "11:30:00",
  "customer_notes": "Looking forward to meeting Sarah Jenkins",
  "translation_enabled": 1,
  "customer_language": "English (US)",
  "helper_language": "Arabic",
  "notify_app": 1,
  "notify_whatsapp": 1,
  "notify_email": 0,
  "notify_call": 0
}
GET

List Interviews

Customer • Interviews
{{base_url}}/api/customer/interviews
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Cancel Interview

Customer • Interviews
{{base_url}}/api/customer/interviews/1/cancel
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "cancel_reason": "Plans changed"
}
GET

Get Maid Availability

Customer • Interviews
{{base_url}}/api/customer/maids/4/availability?date=2024-10-14
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Vendor Interview Settings

Customer • Interviews
{{base_url}}/api/customer/vendors/1/interview-settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Interview Details

Customer • Interviews
{{base_url}}/api/customer/interviews/1
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Reschedule Interview Request

Customer • Interviews
{{base_url}}/api/customer/interviews/1/reschedule
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
    "interview_date": "2026-06-24",
    "time_from": "14:00:00",
    "time_to": "14:30:00"
}
GET

Get Home Data

Customer • Home
{{base_url}}/api/customer/home
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Search Marketplace

Customer • Marketplace
{{base_url}}/api/customer/search?searchTerm=Sarah&type=maids&page=1&limit=10&sortBy=best_match&nationality_ids=&specialty_ids=&skill_ids=&language_ids=&city_ids=&salary_min=&salary_max=&experience_min=&experience_max=&visa_included=&reference_checked=&available_now=1&package_includes=
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Maids with Filters

Customer • Marketplace
{{base_url}}/api/customer/maids?searchTerm=Sarah&page=1&limit=10&sortBy=best_match&nationality_ids=&specialty_ids=&skill_ids=&language_ids=&city_ids=&salary_min=&salary_max=&experience_min=&experience_max=&contract_type=&visa_included=&reference_checked=&available_now=1&available_soon=&package_includes=
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Agency Vendors

Customer • Marketplace
{{base_url}}/api/customer/vendors?searchTerm=&city_ids=&specialty_ids=&package_includes=
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Vendor Details

Customer • Marketplace
{{base_url}}/api/customer/vendors/5
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Maid Profile

Customer • Marketplace
{{base_url}}/api/customer/maids/12
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Saved Maids

Customer • Favorites
{{base_url}}/api/customer/favorites/maids
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Toggle Favorite Maid

Customer • Favorites
{{base_url}}/api/customer/favorites/maids
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "maid_id": 12
}
GET

List Saved Vendors

Customer • Favorites
{{base_url}}/api/customer/favorites/vendors
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Toggle Favorite Vendor

Customer • Favorites
{{base_url}}/api/customer/favorites/vendors
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "vendor_id": 5
}
GET

List Quotations

Customer • Quotations
{{base_url}}/api/customer/quotations
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Quotation Details

Customer • Quotations
{{base_url}}/api/customer/quotations/1
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Accept or Decline Quotation

Customer • Quotations
{{base_url}}/api/customer/quotations/1/action
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
    "status": "accepted"
}
POST

Sign Quotation / Contract

Customer • Quotations
{{base_url}}/api/customer/quotations/:id/sign
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "terms_accepted": true
}
GET

List Chat Rooms

Customer • Chat
{{base_url}}/api/customer/chat/rooms
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Register Chat Reference

Customer • Chat
{{base_url}}/api/customer/chat/rooms/create
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "firebase_chat_id": "room_cust1_vend5",
  "vendor_id": 5,
  "maid_id": 12
}
GET

List Notifications

Customer • Notifications
{{base_url}}/api/customer/notifications
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Read Notification

Customer • Notifications
{{base_url}}/api/customer/notifications/1/read
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Read All Notifications

Customer • Notifications
{{base_url}}/api/customer/notifications/read-all
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Submit Review

Customer • Reviews
{{base_url}}/api/customer/reviews
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "rating": 4.5,
  "comment": "Excellent and very professional maid.",
  "maid_id": 12
}
GET

List Support Tickets

Customer • Support
{{base_url}}/api/customer/support/tickets
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Raise Support Ticket

Customer • Support
{{base_url}}/api/customer/support/tickets
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "subject": "Quotation pending approval",
  "message": "It has been 2 days since my quotation request was sent. Please assist."
}
GET

Get Notification Settings

Customer • Notification Settings
{{base_url}}/api/customer/notification-settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Update Notification Settings

Customer • Notification Settings
{{base_url}}/api/customer/notification-settings/update
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "enable_push": true,
  "booking_updates": true,
  "messages": true,
  "account_activity": false
}
POST

Register

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/register
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
JSON Request Body
{
  "agency_name": "Premium Maids Dubai",
  "email": "info@premiummaids.com",
  "phone": "041234567",
  "password": "password123"
}
POST

Login

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/login
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
JSON Request Body
{
  "email": "vendor@test.com",
  "password": "123456"
}
GET

Profile Details

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/profile
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Forgot Password

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/forgot-password
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
JSON Request Body
{
  "email": "info@premiummaids.com"
}
POST

Reset Password

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/reset-password
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
JSON Request Body
{
  "token": "YOUR_RESET_TOKEN",
  "password": "newpassword123"
}
POST

Change Password

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/change-password
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "old_password": "password123",
  "new_password": "newpassword123"
}
POST

Update Profile

Vendor • Auth & Settings
{{base_url}}/api/vendor/auth/profile/update
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "agency_name": "Premium Maids Dubai LLC",
  "tagline": "Top rated maid service in UAE",
  "description": "Providing experienced housekeepers across Dubai.",
  "phone": "0501234567",
  "address": "Marina Gate 1, Dubai Marina",
  "preferred_language": "en",
  "country_id": 1,
  "city_id": 1
}
GET

Load Analytics Stats

Vendor • Dashboard & Stats
{{base_url}}/api/vendor/dashboard/stats
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Maids

Vendor • Maids & Media
{{base_url}}/api/vendor/maids
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

STEP 1 — Create Maid Draft (Personal Info)

Vendor • Maids & Media
{{base_url}}/api/vendor/maids
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "first_name": "Sarah",
  "last_name": "Jenkins",
  "nationality_id": 5,
  "gender": "female",
  "date_of_birth": "1994-05-15",
  "marital_status": "single",
  "language_ids": [
    {"id": 1, "proficiency": "fluent"},
    {"id": 2, "proficiency": "native"}
  ]
}
POST

STEP 1b — Sync Languages

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/languages
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "languages": [
    {"id": 1, "proficiency": "fluent"},
    {"id": 2, "proficiency": "native"}
  ]
}
PUT

STEP 2 — Work Details

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "years_experience": 5,
  "experience_location": "Dubai, UAE",
  "service_model_id": 1,
  "monthly_salary": 3500,
  "bio": "Hi, I'm Sarah! I specialize in full-time household management, deep cleaning, and organizing."
}
POST

STEP 2b — Sync Specialties

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/specialties
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "specialty_ids": [1, 2, 3, 4],
  "custom_speciality": "Taking care of elders"
}
POST

STEP 2c — Sync Skills

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/skills
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "skill_ids": [1, 2, 5]
}
POST

STEP 3 — Upload Profile Photo

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/photo
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
Multipart Form Data Fields
Field Key Type Example / Src
profile_image file File Upload Stream
POST

STEP 3b — Upload Document (Passport / Emirates ID / Medical)

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/documents
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
Multipart Form Data Fields
Field Key Type Example / Src
document_type_id text 1
expiry_date text 2028-05-01
document file File Upload Stream
PUT

STEP 4 — Set Availability

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "availability_status": "available",
  "available_from": "2024-10-15",
  "service_model_id": 1
}
POST

STEP 4 FINAL — Publish Profile

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/status
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "status": "published"
}
POST

Add Maid

Vendor • Maids & Media
{{base_url}}/api/vendor/maids
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "full_name": "Maria Santos",
  "nationality_id": 5,
  "monthly_salary": 1800,
  "experience_years": 4,
  "date_of_birth": "1992-05-15",
  "gender": "female"
}
PUT

Update Maid Details

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "full_name": "Maria Santos Alcantara",
  "monthly_salary": 1950,
  "availability_status": "available"
}
DELETE

Delete Maid

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Upload Gallery Photos

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/gallery
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
Multipart Form Data Fields
Field Key Type Example / Src
images[] file File Upload Stream
DELETE

Delete Gallery Photo

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/gallery/45
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Upload Maid Passport/Documents

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/documents
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
Multipart Form Data Fields
Field Key Type Example / Src
document_type_id text 3
expiry_date text 2029-12-31
document file File Upload Stream
GET

Get Maid Details

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Update Listing Status

Vendor • Maids & Media
{{base_url}}/api/vendor/maids/12/status
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "status": "published"
}
POST

Add Work Experience

Vendor • Work Experience
{{base_url}}/api/vendor/maids/12/experience
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "job_title": "Full-time Housemaid",
  "employer": "Al Rashid Family",
  "location": "Dubai Hills, Dubai UAE",
  "description": "Managing a 5-bedroom villa in Dubai Hills. Responsibilities include deep cleaning, laundry, and assisting with children.",
  "date_from": "2021-01-01",
  "date_to": null,
  "is_current": true
}
PUT

Update Work Experience

Vendor • Work Experience
{{base_url}}/api/vendor/maids/12/experience/3
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "job_title": "Senior Housekeeper",
  "description": "Updated job responsibilities.",
  "is_current": false,
  "date_to": "2023-06-30"
}
DELETE

Delete Work Experience

Vendor • Work Experience
{{base_url}}/api/vendor/maids/12/experience/3
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Scheduled Interviews

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews?status=confirmed
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Interview Details

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/5
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Interview Reschedule Availability Slots

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/5/availability?date=2026-06-15
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Transition Interview Status

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/5/status
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "status": "confirmed",
  "meeting_link": "https://meet.google.com/azu-hori-xyz",
  "notes": "Ensure you have a good internet connection."
}
POST

Reschedule Interview Request (Vendor)

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/5/reschedule
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "interview_date": "2024-10-25",
  "time_from": "10:30:00",
  "time_to": "11:15:00",
  "notes": "Proposing a new time slot."
}
GET

Fetch Availability Settings

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/availability
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Save Availability Working Days

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/availability
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "slots": [
    {
      "day_of_week": "monday",
      "time_from": "09:00:00",
      "time_to": "17:00:00"
    },
    {
      "day_of_week": "wednesday",
      "time_from": "10:00:00",
      "time_to": "16:00:00"
    }
  ]
}
POST

Save Availability Duration & Timezone

Vendor • Interviews Scheduler
{{base_url}}/api/vendor/interviews/settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "timezone": "Asia/Dubai",
  "duration_minutes": 45
}
GET

Quotation Inquiries Requests

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/requests
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Quotation Request Status Update

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/requests/10/status
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "status": "declined",
  "decline_reason": "Location is outside service area",
  "decline_message": "We currently do not serve the Al-Maktoum region."
}
GET

List Quotations Ledger

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/quotations
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Create Quotation Draft

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/quotations
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "quotation_request_id": 1003,
  "customer_id": 1,
  "maid_id": null,
  "base_salary": 2400,
  "visa_processing": 450,
  "health_insurance": 180,
  "service_fee": 120,
  "notes": "Testing general quote creation with inclusions",
  "background_checks": true,
  "medical_coverage": true,
  "replacement_guarantee": false
}
POST

Send Quotation

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/quotations/15/send
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Send Quotation

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/quotations/15/send
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Quotation Request Details

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/requests/1003
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Quotation Details

Vendor • Quotation Requests & Quotations
{{base_url}}/api/vendor/business/quotations/1000
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

View Active Subscription Plan

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/subscription
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Quota Usage

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/quota
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Cancel Subscription

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/subscription/cancel
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Saved Payment Cards

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/payment-methods
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Save Credit Card

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/payment-methods
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "payment_method_id": 1,
  "card_last_four": "4242",
  "card_brand": "Visa",
  "expiry_month": "12",
  "expiry_year": "2028",
  "is_default": 1
}
DELETE

Delete Credit Card

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/payment-methods/8
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Toggle Subscription Auto-Renew

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/subscription/toggle-auto-renew
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "auto_renew": true
}
GET

Download Invoice PDF

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/payments/1/invoice
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Billing Addresses

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/billing-addresses
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Add Billing Address

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/billing-addresses
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "address_label": "Office",
  "name_or_company": "Azure Horizon Agency",
  "country_region": "United Arab Emirates",
  "street_address": "Office 402, Business Bay",
  "apt_suite_office": "Office 402",
  "city": "Dubai",
  "postal_zip": "00000",
  "is_default": true
}
PUT

Update Billing Address

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/billing-addresses/1
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "address_label": "Office",
  "name_or_company": "Azure Horizon Agency",
  "country_region": "United Arab Emirates",
  "street_address": "Office 402, Business Bay",
  "apt_suite_office": "Office 402",
  "city": "Dubai",
  "postal_zip": "00000",
  "is_default": true
}
DELETE

Delete Billing Address

Vendor • Subscriptions & Billing
{{base_url}}/api/vendor/business/billing-addresses/1
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

List Company Documents

Vendor • Documents
{{base_url}}/api/vendor/documents
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Upload Company Document

Vendor • Documents
{{base_url}}/api/vendor/documents
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
Multipart Form Data Fields
Field Key Type Example / Src
document_type_id text 2
expiry_date text 2026-12-31
document file File Upload Stream
GET

List Chat Room References

Vendor • Chats
{{base_url}}/api/vendor/chat/rooms
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Log Chat Room Reference

Vendor • Chats
{{base_url}}/api/vendor/chat/rooms
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "firebase_chat_id": "chat_room_889",
  "customer_id": 2,
  "maid_id": 12,
  "quotation_request_id": 10
}
GET

List Log Notifications

Vendor • Notifications Ledger
{{base_url}}/api/vendor/notifications
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Mark Read

Vendor • Notifications Ledger
{{base_url}}/api/vendor/notifications/44/read
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Mark All Read

Vendor • Notifications Ledger
{{base_url}}/api/vendor/notifications/read-all
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

GET

Get Notification Settings

Vendor • Notifications Ledger
{{base_url}}/api/vendor/notifications/settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Update Notification Settings

Vendor • Notifications Ledger
{{base_url}}/api/vendor/notifications/settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "enable_push": true,
  "booking_updates": true,
  "messages": true,
  "account_activity": false
}
GET

List Support Tickets

Vendor • Support System
{{base_url}}/api/vendor/support/tickets
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Open Support Ticket

Vendor • Support System
{{base_url}}/api/vendor/support/tickets
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "subject": "App Subscription Upgrade Issue",
  "message": "My credit card was charged but the subscription plan remains Basic. Please upgrade to Professional."
}
GET

Get Interview Settings

Vendor • Scheduler & Interview Settings
{{base_url}}/api/vendor/interviews/settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.

No request payload needed for this endpoint.

POST

Update Interview Settings

Vendor • Scheduler & Interview Settings
{{base_url}}/api/vendor/interviews/settings
Headers
Header Name Required Value Description
Content-Type application/json Informs server that request payload uses JSON structure.
Authorization Bearer {jwt_token} JWT Required Access Token generated from login endpoint.
JSON Request Body
{
  "timezone": "Gulf Standard Time (GST)",
  "duration_minutes": 45,
  "availability": [
    {
      "day_of_week": "monday",
      "is_available": true,
      "slots": [
        {"from": "09:00 AM", "to": "06:00 PM"}
      ]
    },
    {
      "day_of_week": "tuesday",
      "is_available": true,
      "slots": [
        {"from": "09:00 AM", "to": "06:00 PM"}
      ]
    },
    {
      "day_of_week": "wednesday",
      "is_available": true,
      "slots": [
        {"from": "09:00 AM", "to": "06:00 PM"}
      ]
    },
    {
      "day_of_week": "thursday",
      "is_available": true,
      "slots": [
        {"from": "09:00 AM", "to": "06:00 PM"}
      ]
    },
    {
      "day_of_week": "friday",
      "is_available": true,
      "slots": [
        {"from": "09:00 AM", "to": "12:00 PM"},
        {"from": "02:00 PM", "to": "06:00 PM"}
      ]
    },
    {
      "day_of_week": "saturday",
      "is_available": false,
      "slots": []
    },
    {
      "day_of_week": "sunday",
      "is_available": false,
      "slots": []
    }
  ]
}