---
updatedAt: 2026-07-20T09:41:00.000Z
agentTools:
  projectIndex: https://volt-docs.travclan.com/llms.txt
---

# Cancel Booking

Cancels a hotel booking using the booking code. Returns cancellation status and booking details.**Note:** For this endpoint, please select the Helper API's Sandbox or Production server from the dropdown in the Base URL panel. Please Note that the bookingStatus in the Success API should be "Cancelled" for a booking to be considered Cancelled"

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "VoltLite API",
    "description": "### Overview\nLightweight, efficient, and fast — the essence of Volt in minimal form.\n\n### Copyright\n© Copyright 2024, TravClan  \nThis document contains confidential material and is the property and copyright of Travclan.  \nNo part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, chemical, photocopying, recording, or otherwise without the prior written permission of Travclan.",
    "version": "1.1.1",
    "contact": {
      "name": "Volt API Support",
      "url": "https://volt.travclan.com/contact",
      "email": "apisupport@travclan.com"
    }
  },
  "servers": [
    {
      "url": "https://hotel-volt-api-sandbox.travclan.com",
      "description": "Volt Lite SandBox"
    },
    {
      "url": "https://hotel-volt-tp.travclan.com",
      "description": "Volt Lite Production"
    },
    {
      "url": "https://hotel-api-sandbox.travclan.com",
      "description": "Helper API's Sandbox"
    },
    {
      "url": "https://hotels-v1-tp.travclan.com",
      "description": "Helper API's Production"
    }
  ],
  "tags": [
    {
      "name": "Booking",
      "description": "APIs related to hotel booking."
    }
  ],
  "paths": {
    "/api/v1/hotels/itineraries/bookings/{bookingCode}/cancel": {
      "post": {
        "operationId": "voltLiteCancelBooking",
        "summary": "Cancel Booking",
        "description": "Cancels a hotel booking using the booking code. Returns cancellation status and booking details.**Note:** For this endpoint, please select the Helper API's Sandbox or Production server from the dropdown in the Base URL panel. Please Note that the bookingStatus in the Success API should be \"Cancelled\" for a booking to be considered Cancelled\"",
        "tags": [
          "Booking"
        ],
        "parameters": [
          {
            "name": "bookingCode",
            "in": "path",
            "required": true,
            "description": "The unique booking code/identifier to cancel.",
            "schema": {
              "type": "string"
            },
            "example": "trt91"
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "description": "Bearer token for authenticating the request.",
            "schema": {
              "type": "string"
            },
            "example": "Bearer {{access_token}}"
          },
          {
            "name": "Authorization-Type",
            "in": "header",
            "required": true,
            "description": "Specifies the type of authorization, here it is set to external-service.",
            "schema": {
              "type": "string",
              "default": "external-service"
            },
            "example": "external-service"
          },
          {
            "name": "source",
            "in": "header",
            "required": true,
            "description": "Specifies the source of the request (End User Source). Available choices: website, android, mweb, ios, mobile.",
            "schema": {
              "type": "string",
              "enum": [
                "website",
                "android",
                "mweb",
                "ios"
              ],
              "default": "website"
            },
            "example": "website"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful cancellation response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "OK"
                    },
                    "error": {
                      "type": "boolean",
                      "example": false
                    },
                    "code": {
                      "type": "integer",
                      "example": 200
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/BookingCancellationResult"
                      }
                    }
                  }
                },
                "example": {
                  "message": "OK",
                  "error": false,
                  "code": 200,
                  "results": [
                    {
                      "bookingId": "trnep",
                      "serviceRequestCode": "srqjya5",
                      "bookingInfo": {
                        "hotelName": "Taj Cidade de Goa Horizon, Goa",
                        "checkIn": "2024-12-02",
                        "checkOut": "2024-12-03",
                        "totalGuests": 2,
                        "totalRooms": 0
                      },
                      "requestStatus": "SERVICE_REQUEST_STATUS_COMPLETED",
                      "bookingStatus": "Cancelled",
                      "message": "Your Booking Has Been Cancelled Successfully."
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. One or more request parameters are invalid or missing."
          },
          "401": {
            "description": "Unauthorized - Invalid or missing token"
          },
          "403": {
            "description": "Forbidden - Insufficient permissions"
          },
          "404": {
            "description": "Not Found. The requested resource could not be located."
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "BookingCancellationResult": {
        "type": "object",
        "properties": {
          "bookingId": {
            "type": "string",
            "description": "The booking code/identifier",
            "example": "trnep"
          },
          "serviceRequestCode": {
            "type": "string",
            "description": "Service request code for the cancellation",
            "example": "srqjya5"
          },
          "bookingInfo": {
            "type": "object",
            "properties": {
              "hotelName": {
                "type": "string",
                "description": "Name of the hotel",
                "example": "Taj Cidade de Goa Horizon, Goa"
              },
              "checkIn": {
                "type": "string",
                "format": "date",
                "description": "Check-in date in YYYY-MM-DD format",
                "example": "2024-12-02"
              },
              "checkOut": {
                "type": "string",
                "format": "date",
                "description": "Check-out date in YYYY-MM-DD format",
                "example": "2024-12-03"
              },
              "totalGuests": {
                "type": "integer",
                "description": "Total number of guests",
                "example": 2
              },
              "totalRooms": {
                "type": "integer",
                "description": "Total number of rooms",
                "example": 0
              }
            }
          },
          "requestStatus": {
            "type": "string",
            "description": "Status of the cancellation request",
            "example": "SERVICE_REQUEST_STATUS_COMPLETED"
          },
          "bookingStatus": {
            "type": "string",
            "description": "Current status of the booking after cancellation",
            "example": "Cancelled"
          },
          "message": {
            "type": "string",
            "description": "Cancellation message",
            "example": "Your Booking Has Been Cancelled Successfully."
          }
        }
      }
    }
  }
}
```