Create a booking

Purpose

Record a new booking against one of your packages. This is the key transactional endpoint — on success we immediately dispatch a signed booking.created webhook to every webhook subscription you have configured, so your own systems (and any partner integrations) stay in sync.

Authentication

Send your access token as a Bearer header: Authorization: Bearer <token>. Obtain it from Authenticate a user.

Parameters

Request samples

curl -X POST https://tourapi.nirajp.com.np/api/v1/bookings \
  -H "Content-Type: application/json" \
  -d '{"packageId":1,"travelDate":"2026-10-04","pax":2,"customerName":"John Smith","customerEmail":"john@example.com"}'

Success response

Returns 200 OK with the shape below.

{
  "success": true,
  "message": "Request successful.",
  "data": {
    "id": 5,
    "packageId": 1,
    "travelDate": "2026-10-04",
    "pax": 2,
    "customerName": "John Smith",
    "status": "pending"
  }
}

Errors

All errors share the envelope { "success": false, "message": "..." }.

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "email": "email must be a valid email"
  }
}

{
  "success": false,
  "message": "Not found"
}

{
  "success": false,
  "message": "Package not bookable"
}

{
  "success": false,
  "message": "Internal server error"
}