POST/v1/hotels/description

Generate hotel description

Generates or retrieves a localized hotel description from the available Travelandz hotel metadata.

Endpoint

Method	Path	Auth
`POST`	`/v1/hotels/description`	Required API key

Required headers:

Header	Description
`Authorization`	`Bearer <secret_key>`. The secret is shown only once when the credential is created.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. The `profile_code` is the `dp_`-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
`Content-Type`	Use `application/json` for requests with a body.

Request Parameters

No path or query params are required.

Request Body Schema

hotelId

stringYes

language

enum

eneszh

Yes

Success Response

Returns localized description text and provider context.

Response Body Schema

description

stringYes

liveMode

booleanYes

True when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.

Example

bash

curl -X POST https://api.sandbox.travelandz.com/v1/hotels/description \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '<request_body_json>'