0
Provider mobile app

API Docs

Use these endpoints for provider login, password reset, assigned bookings, attendance, and live coordinate tracking.

Base URL https://creekworld.in Send JSON requests. Protected endpoints require the login token in the Authorization header.
POST

Provider Login

/api/provider/login
No token required.

Endpoint

POST /api/provider/login

Request

{
    "mobile": "9876543211",
    "password": "password1"
}

Response

{
    "status": true,
    "message": "Provider login successful.",
    "token_type": "Bearer",
    "token": "LOGIN_TOKEN",
    "expires_at": "2026-09-01T10:00:00+05:30",
    "track_refresh_interval": 30,
    "profile": {
        "id": 1,
        "name": "Mobile Provider",
        "profile_photo": "https://example.com/storage/providers/profile-photos/provider.jpg",
        "mobile": "9876543211",
        "email": "provider@example.com",
        "address": "12 Provider Lane",
        "work_area": "Srinagar, Gulmarg"
    }
}
POST

Forgot Password - Send OTP

/api/provider/forgot-password
No token required.

Endpoint

POST /api/provider/forgot-password

Request

{
    "mobile": "9876543211"
}

Response

{
    "status": true,
    "message": "We sent a verification OTP to your WhatsApp number.",
    "expires_in": 600,
    "resend_after": 60
}
POST

Forgot Password - Verify OTP

/api/provider/forgot-password/verify
No token required.

Endpoint

POST /api/provider/forgot-password/verify

Request

{
    "mobile": "9876543211",
    "otp": "123456"
}

Response

{
    "status": true,
    "message": "OTP verified. You can reset your password now.",
    "reset_token": "RESET_TOKEN"
}
POST

Forgot Password - Resend OTP

/api/provider/forgot-password/resend
No token required.

Endpoint

POST /api/provider/forgot-password/resend

Request

{
    "mobile": "9876543211"
}

Response

{
    "status": true,
    "message": "We sent a new OTP to your WhatsApp number.",
    "expires_in": 600,
    "resend_after": 60
}
POST

Reset Password

/api/provider/reset-password
No token required. Use reset_token from OTP verification.

Endpoint

POST /api/provider/reset-password

Request

{
    "mobile": "9876543211",
    "reset_token": "RESET_TOKEN",
    "password": "newpass1",
    "password_confirmation": "newpass1"
}

Response

{
    "status": true,
    "message": "Your password has been reset. Please sign in."
}
POST

Provider Attendance Toggle

/api/provider/attendance/toggle
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/attendance/toggle

Request

{
    "is_checked_in": true
}

Response

{
    "status": true,
    "message": "Provider checked in successfully.",
    "is_checked_in": true,
    "attendance": {
        "id": 1,
        "provider_id": 1,
        "date": "2026-08-02",
        "check_in_date": "2026-08-02",
        "check_in_time": "09:30:00",
        "check_in_at": "2026-08-02T09:30:00+05:30",
        "check_out_date": null,
        "check_out_time": null,
        "check_out_at": null
    }
}
GET

Provider Assigned Bookings

/api/provider/bookings/assigned?status=assigned,confirmed&per_page=15&page=1
Authorization: Bearer LOGIN_TOKEN

Endpoint

GET /api/provider/bookings/assigned?status=assigned,confirmed&per_page=15&page=1

Request

{
    "status": "assigned,confirmed",
    "per_page": 15,
    "page": 1
}

Response

{
    "status": true,
    "message": "Assigned bookings fetched successfully.",
    "provider_id": 1,
    "filters": {
        "status": [
            "assigned",
            "confirmed"
        ]
    },
    "bookings": [
        {
            "id": 30,
            "reference": "CW-260810-WHFTMK",
            "invoice_number": "INV-CW260810WHFTMK-00030",
            "status": "assigned",
            "payment_status": "paid",
            "payment_method": "razorpay",
            "customer": {
                "name": "Mohit Sharma",
                "phone": "9876543210",
                "email": "mohit@example.com",
                "type": "Men"
            },
            "service": {
                "name": "Hair Services / Haircut",
                "items": [
                    {
                        "id": 51,
                        "subservice_id": 51,
                        "service_name": "Hair Services",
                        "subservice_name": "Haircut",
                        "display_name": "Hair Services / Haircut",
                        "amount": 499
                    }
                ]
            },
            "schedule": {
                "date": "2026-08-12",
                "display_date": "12 Aug 2026",
                "time": "08:00:00",
                "display_time": "8:00 AM"
            },
            "location": {
                "address": "Krishna Apartment",
                "google_map_address": "Krishna Apartment, Delhi",
                "city": "Delhi",
                "pincode": "110078",
                "latitude": 28.6139,
                "longitude": 77.209
            },
            "amount": {
                "total": 499
            },
            "notes": "Please call before arrival.",
            "assigned_at": "2026-08-10T10:00:00+05:30",
            "service_started_at": null,
            "service_completed_at": null,
            "created_at": "2026-08-10T09:20:00+05:30"
        }
    ]
}
POST

Provider Accept Booking

/api/provider/bookings/30/accept
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/bookings/30/accept

Request

[]

Response

{
    "status": true,
    "message": "Booking accepted successfully.",
    "customer_notified": true,
    "booking": {
        "id": 30,
        "reference": "CW-260810-WHFTMK",
        "status": "confirmed",
        "provider_id": 1,
        "assigned_at": "2026-08-10T10:00:00+05:30",
        "schedule": {
            "date": "2026-08-12",
            "time": "08:00:00",
            "display_time": "8:00 AM"
        }
    }
}
GET

Provider Accepted Bookings

/api/provider/bookings/accepted?per_page=15&page=1
Authorization: Bearer LOGIN_TOKEN

Endpoint

GET /api/provider/bookings/accepted?per_page=15&page=1

Request

{
    "per_page": 15,
    "page": 1
}

Response

{
    "status": true,
    "message": "Accepted bookings fetched successfully.",
    "provider_id": 1,
    "filters": {
        "status": [
            "confirmed"
        ]
    },
    "bookings": [
        {
            "id": 30,
            "reference": "CW-260821-YB7PHE",
            "status": "ACCEPTED",
            "service": "Men - Clean Shave",
            "date": "22 Aug 2026",
            "time": "10:00 AM",
            "customer_name": "Rohit",
            "phone": "7651925690",
            "address": "RZ-78, New Delhi 110078",
            "google_map_address": "RZ-78, New Delhi 110078",
            "google_map_latitude": "28.613913",
            "google_map_longitude": "77.209988"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 15,
        "total": 1,
        "last_page": 1
    }
}
POST

Provider Reject Booking

/api/provider/bookings/30/reject
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/bookings/30/reject

Request

[]

Response

{
    "status": true,
    "message": "Booking rejected. Admin can assign it to another provider.",
    "booking": {
        "id": 30,
        "reference": "CW-260810-WHFTMK",
        "status": "pending",
        "provider_id": null,
        "assigned_at": null,
        "schedule": {
            "date": "2026-08-12",
            "time": "08:00:00",
            "display_time": "8:00 AM"
        }
    }
}
POST

Provider Send Start Code

/api/provider/bookings/30/start-code
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/bookings/30/start-code

Request

[]

Response

{
    "status": true,
    "message": "Start service code sent to the customer on WhatsApp.",
    "code_sent": true,
    "booking": {
        "id": 30,
        "reference": "CW-260810-WHFTMK",
        "invoice_number": null,
        "status": "confirmed",
        "payment_status": "pending",
        "payment_method": "cash_after_service",
        "provider_id": 1,
        "schedule": {
            "date": "2026-08-12",
            "time": "08:00:00",
            "display_time": "8:00 AM"
        },
        "service_started_at": null,
        "service_completed_at": null
    }
}
POST

Provider Start Service

/api/provider/bookings/30/start
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/bookings/30/start

Request

{
    "service_start_code": "123456"
}

Response

{
    "status": true,
    "message": "Service started successfully.",
    "booking": {
        "id": 30,
        "reference": "CW-260810-WHFTMK",
        "invoice_number": null,
        "status": "in_progress",
        "payment_status": "pending",
        "payment_method": "cash_after_service",
        "provider_id": 1,
        "schedule": {
            "date": "2026-08-12",
            "time": "08:00:00",
            "display_time": "8:00 AM"
        },
        "service_started_at": "2026-08-12T08:05:00+05:30",
        "service_completed_at": null
    }
}
POST

Provider Send Complete Code

/api/provider/bookings/30/complete-code
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/bookings/30/complete-code

Request

[]

Response

{
    "status": true,
    "message": "Complete service code sent to the customer on WhatsApp.",
    "code_sent": true,
    "booking": {
        "id": 30,
        "reference": "CW-260810-WHFTMK",
        "invoice_number": null,
        "status": "in_progress",
        "payment_status": "pending",
        "payment_method": "cash_after_service",
        "provider_id": 1,
        "schedule": {
            "date": "2026-08-12",
            "time": "08:00:00",
            "display_time": "8:00 AM"
        },
        "service_started_at": "2026-08-12T08:05:00+05:30",
        "service_completed_at": null
    }
}
POST

Provider Complete Service

/api/provider/bookings/30/complete
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/bookings/30/complete

Request

{
    "service_complete_code": "654321",
    "payment_status": "paid"
}

Response

{
    "status": true,
    "message": "Service completed successfully.",
    "invoice_sent": true,
    "booking": {
        "id": 30,
        "reference": "CW-260810-WHFTMK",
        "invoice_number": "INV-CW260810WHFTMK-00030",
        "status": "completed",
        "payment_status": "paid",
        "payment_method": "cash_after_service",
        "provider_id": 1,
        "schedule": {
            "date": "2026-08-12",
            "time": "08:00:00",
            "display_time": "8:00 AM"
        },
        "service_started_at": "2026-08-12T08:05:00+05:30",
        "service_completed_at": "2026-08-12T09:15:00+05:30"
    }
}
POST

Provider Track Coordinates

/api/provider/track-coordinates
Authorization: Bearer LOGIN_TOKEN

Endpoint

POST /api/provider/track-coordinates

Request

{
    "latitude": 34.0836567,
    "longitude": 74.7973712,
    "accuracy": 8.5
}

Response

{
    "status": true,
    "message": "Provider coordinates stored successfully.",
    "coordinate": {
        "id": 1,
        "provider_id": 1,
        "latitude": 34.0836567,
        "longitude": 74.7973712,
        "accuracy": 8.5,
        "date": "2026-08-02",
        "time": "11:20:30",
        "tracked_at": "2026-08-02T11:20:30+05:30"
    }
}
Book Now