---
updatedAt: 2026-09-21T14:29:33.000Z
agentTools:
  projectIndex: https://volt-docs.travclan.com/llms.txt
---

# Get Booking Details by Trace ID

Retrieves detailed booking information for a specific booking using the trace ID. Returns itinerary details, guest information, hotel static content, and booking status. This endpoint has the same response structure as the booking details by booking code endpoint.

**Note:** For this endpoint, please select the Helper API's Sandbox or Production server from the dropdown in the Base URL panel.

In case, the connection may drop while a booking is being created before the `bookingCode` reaches the Merchant. In this situation, do not retry the `book` — call below cURL to fetch the current status of that booking attempt instead.

```curl
curl --location '{{host_url}}/api/v1/hotels/itineraries/bookings/status/{{traceId}}' \
--header 'Authorization: {{token}}' \
--header 'Authorization-Type: external-service' \
--header 'source: website' \
--header 'Authorization-mode: AWSCognito'
```

`This API can only be called within 30 minutes of the original booking creation attempt.`

After 30 minutes, the API will no longer return the status, and you'll instead receive:

```json
{
  "message": "Internal Server Error. Please Try Again.",
  "httpStatusCode": 500,
  "error": {
    "code": 1058,
    "message": "The api /itineraries/bookings/status/<traceId> that you have called is unable to return data. Please raise a request with b2bhotels@travclan.com",
    "traceId": "<traceId>"
  }
}
```

If this window has passed, do not attempt to resolve it via API — raise a query with the actual booking details (trace id, guest names & search criteria) to <b2bhotels@travclan.com> to get the current booking status manually.

# 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/status/{traceId}": {
      "get": {
        "operationId": "voltLiteGetBookingDetailsByTraceId",
        "summary": "Get Booking Details by Trace ID",
        "description": "Retrieves detailed booking information for a specific booking using the trace ID. Returns itinerary details, guest information, hotel static content, and booking status. This endpoint has the same response structure as the booking details by booking code endpoint.\n\n**Note:** For this endpoint, please select the Helper API's Sandbox or Production server from the dropdown in the Base URL panel.",
        "tags": [
          "Booking"
        ],
        "parameters": [
          {
            "name": "traceId",
            "in": "path",
            "required": true,
            "description": "The unique trace identifier for the booking.",
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "example": "3d1ae9b4-d638-4928-a1c4-d2cb98eec935"
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "description": "Bearer token for authenticating the request.",
            "schema": {
              "type": "string"
            },
            "example": "Bearer {{access_token}}"
          },
          {
            "name": "Authorization-Mode",
            "in": "header",
            "required": false,
            "description": "Specifies the authorization mode (e.g., AWSCognito).",
            "schema": {
              "type": "string",
              "default": "AWSCognito"
            },
            "example": "AWSCognito"
          },
          {
            "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 response with booking details",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "OK"
                    },
                    "error": {
                      "type": "boolean",
                      "example": false
                    },
                    "code": {
                      "type": "integer",
                      "example": 200
                    },
                    "results": {
                      "type": "object",
                      "properties": {
                        "hotel_itinerary": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/HotelItinerary"
                          }
                        },
                        "status": {
                          "type": "string",
                          "description": "Booking status (e.g., Confirmed, Pending, Failed)",
                          "example": "Confirmed"
                        },
                        "voucherLink": {
                          "type": "string",
                          "nullable": true,
                          "example": null
                        },
                        "providerConfirmationNumber": {
                          "type": "string",
                          "description": "Confirmation number provided by the booking provider",
                          "example": "148-5989072"
                        },
                        "specialRequests": {
                          "type": "string",
                          "nullable": true,
                          "example": "null"
                        },
                        "errorMessage": {
                          "type": "string",
                          "nullable": true,
                          "example": null
                        }
                      }
                    }
                  }
                },
                "example": {
                  "message": "OK",
                  "error": false,
                  "code": 200,
                  "results": {
                    "hotel_itinerary": [
                      {
                        "traceId": "3d1ae9b4-d638-4928-a1c4-d2cb98eec935",
                        "code": "itrpkgs",
                        "totalAmount": 54333
                      }
                    ],
                    "status": "Confirmed",
                    "providerConfirmationNumber": "148-5989072"
                  }
                }
              }
            }
          },
          "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": {
      "HotelStaticContent": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Hotel identifier",
            "example": "32168600"
          },
          "name": {
            "type": "string",
            "description": "Hotel name",
            "example": "Yas Plaza Mangroves"
          },
          "providerId": {
            "type": "string",
            "description": "Provider identifier",
            "example": "79"
          },
          "providerHotelId": {
            "type": "string",
            "description": "Provider hotel identifier",
            "example": "2852940"
          },
          "providerName": {
            "type": "string",
            "description": "Provider name",
            "example": "P79"
          },
          "language": {
            "type": "string",
            "description": "Language code",
            "example": "en-US"
          },
          "geoCode": {
            "type": "object",
            "properties": {
              "lat": {
                "type": "string",
                "example": "24.467224"
              },
              "long": {
                "type": "string",
                "example": "54.60302"
              }
            }
          },
          "neighbourhoods": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "contact": {
            "type": "object",
            "properties": {
              "address": {
                "type": "object",
                "properties": {
                  "line1": {
                    "type": "string"
                  },
                  "city": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      }
                    }
                  },
                  "state": {
                    "type": "object"
                  },
                  "country": {
                    "type": "object",
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      }
                    }
                  }
                }
              },
              "phones": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fax": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "chainCode": {
            "type": "string",
            "example": "-7"
          },
          "chainName": {
            "type": "string",
            "example": "IHG"
          },
          "type": {
            "type": "string",
            "example": "Hotel"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "amenities",
                    "dining",
                    "business_amenities",
                    "rooms",
                    "attractions",
                    "location",
                    "headline",
                    "spoken_languages",
                    "onsite_payments"
                  ]
                },
                "text": {
                  "type": "string"
                }
              }
            }
          },
          "category": {
            "type": "string",
            "example": "Hotel"
          },
          "starRating": {
            "type": "string",
            "example": "4"
          },
          "facilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "groupId": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                }
              }
            }
          },
          "facilityGroups": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "culture": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              }
            }
          },
          "nearByAttractions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "distance": {
                  "type": "string"
                },
                "unit": {
                  "type": "string"
                }
              }
            }
          },
          "images": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "links": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "size": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string"
                      }
                    }
                  }
                },
                "caption": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "roomCodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "policies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              }
            }
          },
          "fees": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "reviews": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "rating": {
                  "type": "string"
                },
                "count": {
                  "type": "string"
                },
                "provider": {
                  "type": "string"
                }
              }
            }
          },
          "checkinInfo": {
            "type": "object",
            "properties": {
              "beginTime": {
                "type": "string"
              },
              "endTime": {
                "type": "string"
              },
              "instructions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "specialInstructions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "minAge": {
                "type": "string"
              }
            }
          },
          "checkoutInfo": {
            "type": "object",
            "properties": {
              "time": {
                "type": "string"
              }
            }
          },
          "heroImage": {
            "type": "string"
          },
          "distance": {
            "type": "string"
          },
          "attributes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              }
            }
          },
          "imageCount": {
            "type": "string"
          },
          "rooms": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "roomId": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "facilities": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "beds": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "Type": {
                        "type": "string"
                      },
                      "Size": {
                        "type": "string"
                      },
                      "Count": {
                        "type": "string"
                      }
                    }
                  }
                },
                "area": {
                  "type": "object"
                },
                "image": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "maxGuestAllowed": {
                  "type": "string"
                },
                "maxAdultAllowed": {
                  "type": "string"
                },
                "maxChildrenAllowed": {
                  "type": "string"
                }
              }
            }
          },
          "imagesAndCaptions": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "captionLabel": {
                  "type": "string"
                },
                "images": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          },
          "groupedFacilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "culture": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "facilities": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "imageUrl": {
                  "type": "string"
                }
              }
            }
          },
          "badges": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "badge_data": {
                  "type": "object"
                },
                "badge_type": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "subtext": {
                  "type": "string"
                },
                "highlight_list": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          },
          "nearByLocation": {
            "type": "object",
            "nullable": true
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "HotelItinerary": {
        "type": "object",
        "properties": {
          "traceId": {
            "type": "string",
            "description": "Unique trace identifier for the booking",
            "example": "19575082-2186-4b39-9670-4963ae59d785"
          },
          "code": {
            "type": "string",
            "description": "Itinerary code",
            "example": "itrpkgs"
          },
          "totalAmount": {
            "type": "number",
            "description": "Total amount for the booking",
            "example": 54333
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "HOTEL"
                  ]
                },
                "isHoldAllowed": {
                  "type": "boolean"
                },
                "travclanHoldTimeLimit": {
                  "type": "string",
                  "nullable": true
                },
                "totalHoldCharges": {
                  "type": "number"
                },
                "selectedRoomsAndRates": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "room": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "roomId": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "beds": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "smokingAllowed": {
                            "type": "boolean"
                          },
                          "facilities": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "guests": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "integer"
                                },
                                "title": {
                                  "type": "string"
                                },
                                "firstName": {
                                  "type": "string"
                                },
                                "lastName": {
                                  "type": "string"
                                },
                                "middleName": {
                                  "type": "string",
                                  "nullable": true
                                },
                                "isLeadGuest": {
                                  "type": "boolean"
                                },
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "adult",
                                    "child"
                                  ]
                                },
                                "isActive": {
                                  "type": "boolean"
                                },
                                "itemRoom_id": {
                                  "type": "integer"
                                },
                                "hms_guestadditionaldetail": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "integer"
                                    },
                                    "age": {
                                      "type": "integer",
                                      "nullable": true
                                    },
                                    "email": {
                                      "type": "string"
                                    },
                                    "isdCode": {
                                      "type": "string"
                                    },
                                    "contactNumber": {
                                      "type": "string"
                                    },
                                    "addressLineOne": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "addressLineTwo": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "panCardNumber": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "passportNumber": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "passportExpiry": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "passportIssue": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "passportFrontImage": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "passportBackImage": {
                                      "type": "string",
                                      "nullable": true
                                    },
                                    "panCardName": {
                                      "type": "string",
                                      "nullable": true
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "rate": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "isRefundable": {
                            "type": "boolean"
                          },
                          "needPriceCheck": {
                            "type": "boolean"
                          },
                          "allGuestInfoRequired": {
                            "type": "boolean"
                          },
                          "onlineCancellable": {
                            "type": "boolean"
                          },
                          "specialRequestSupported": {
                            "type": "boolean"
                          },
                          "payAtHotel": {
                            "type": "boolean"
                          },
                          "cardRequired": {
                            "type": "boolean"
                          },
                          "baseRate": {
                            "type": "number"
                          },
                          "totalRate": {
                            "type": "number"
                          },
                          "sellRate": {
                            "type": "number",
                            "nullable": true
                          },
                          "affiliateDiscount": {
                            "type": "number",
                            "nullable": true
                          },
                          "minSellingRate": {
                            "type": "number"
                          },
                          "publishedRate": {
                            "type": "number"
                          },
                          "finalRate": {
                            "type": "number"
                          },
                          "taxAmount": {
                            "type": "number"
                          },
                          "salesTax": {
                            "type": "number",
                            "nullable": true
                          },
                          "dailyRates": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "amount": {
                                  "type": "number"
                                },
                                "date": {
                                  "type": "string",
                                  "format": "date-time"
                                },
                                "taxIncluded": {
                                  "type": "boolean"
                                },
                                "discount": {
                                  "type": "number"
                                }
                              }
                            }
                          },
                          "supplierV2_id": {
                            "type": "integer"
                          },
                          "boardBasis": {
                            "type": "object",
                            "properties": {
                              "description": {
                                "type": "string"
                              },
                              "type": {
                                "type": "string"
                              }
                            }
                          },
                          "cancellationPolicies": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "text": {
                                  "type": "string"
                                },
                                "rules": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "estimatedValue": {
                                        "type": "number"
                                      },
                                      "start": {
                                        "type": "string",
                                        "format": "date-time"
                                      },
                                      "end": {
                                        "type": "string",
                                        "format": "date-time"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          },
                          "policies": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string"
                                },
                                "text": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "additionalCharges": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "includes": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "supplier": {
                            "type": "integer"
                          },
                          "providerRateId": {
                            "type": "string"
                          },
                          "deleted": {
                            "type": "boolean"
                          },
                          "isPackageRate": {
                            "type": "boolean"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "isPassportMandatory": {
                            "type": "boolean"
                          },
                          "isPANMandatory": {
                            "type": "boolean"
                          },
                          "allowedCreditCards": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "taxes": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "commission": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "otherRateComponents": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "totalDefaultMarkup": {
                            "type": "number"
                          },
                          "finalRateWithDefaultAgentMarkup": {
                            "type": "number"
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "item_id": {
                            "type": "integer"
                          },
                          "hms_itemrooms": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "providerId": {
                            "type": "string"
                          },
                          "providerName": {
                            "type": "string"
                          },
                          "refundable": {
                            "type": "boolean"
                          },
                          "refundability": {
                            "type": "string"
                          },
                          "needsPriceCheck": {
                            "type": "boolean"
                          },
                          "occupancies": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          }
                        }
                      },
                      "occupancy": {
                        "type": "object",
                        "properties": {
                          "adults": {
                            "type": "string"
                          },
                          "childAges": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "staticContent": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HotelStaticContent"
            }
          },
          "guestCollectionData": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "guests": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "guestCount": {
                  "type": "integer"
                }
              }
            }
          },
          "searchRequestLog": {
            "type": "object",
            "properties": {
              "checkIn": {
                "type": "string",
                "format": "date"
              },
              "checkOut": {
                "type": "string",
                "format": "date"
              },
              "occupancies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "numOfAdults": {
                      "type": "integer"
                    },
                    "childAges": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      }
                    }
                  }
                }
              }
            }
          },
          "guestRules": {
            "type": "object",
            "properties": {
              "allGuestsInfoRequired": {
                "type": "boolean"
              },
              "isPassportMandatory": {
                "type": "boolean"
              },
              "isPANMandatory": {
                "type": "boolean"
              },
              "leadGuest": {
                "type": "object",
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "isVisible": {
                      "type": "boolean"
                    },
                    "isMandatoryIfVisible": {
                      "type": "boolean"
                    }
                  }
                }
              },
              "guestTypeAdult": {
                "type": "object",
                "additionalProperties": {
                  "type": "object"
                }
              },
              "guestTypeChild": {
                "type": "object",
                "additionalProperties": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}
```