{"items":[{"type":"link","label":"Messaging API","link":"/demand/docs/additional-services/messaging/messaging","routeSlug":"/demand/docs/additional-services/messaging/messaging","content":{"contentType":"overview","meta":{"name":"Messaging API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"messaging.json","url":"/_bundle/demand/docs/additional-services/messaging/messaging.json?download"},{"kind":"download","label":"messaging.yaml","url":"/_bundle/demand/docs/additional-services/messaging/messaging.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Messaging API (3.3.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Messaging API lets affiliate partners exchange messages between guests and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"properties on behalf of their users."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use it to retrieve conversations, read the latest messages, send new messages,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"confirm receipt, and upload or download attachments."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All requests require authentication using your Affiliate identifier"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"X-Affiliate-Id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header) together with your token credentials."},"children":[]}]}]}]}],"sectionId":"/demand/docs/additional-services/messaging/messaging"}],"sectionId":"/demand/docs/additional-services/messaging/messaging"}]}]}},{"type":"group","label":"Conversations","link":"/demand/docs/additional-services/messaging/messaging/conversations","routeSlug":"/demand/docs/additional-services/messaging/messaging/conversations","items":[{"label":"Retrieve a conversation","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/conversations/conversations","routeSlug":"/demand/docs/additional-services/messaging/messaging/conversations/conversations","metadata":{"seo":{"title":"Retrieve a conversation","description":"Use this endpoint to retrieve a conversation available to the authenticated user."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"conversations","name":"Retrieve a conversation","isWebhook":false,"pointer":"/paths/~1messages~1conversations/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a conversation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to retrieve a conversation available to the authenticated user."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1conversations/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample","paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample"]}},"schemaId":"components/schemas/input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample","paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample"],"pointer":"/paths/~1messages~1conversations/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/conversations","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample","paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample"]}},"responseCodes":["200"],"pointer":"/messages/conversations","href":"conversations/conversations","openApiOperationId":"conversations","summary":"Retrieve a conversation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample","paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input","exampleIds":["paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample","paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Conversation retrieved successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1conversations/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output","exampleIds":["paths/~1messages~1conversations/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/conversations"}],"content":{"contentType":"group","meta":{"name":"Conversations"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Conversations","showPageActions":true},{"nodeType":"markdoc","content":"Retrieve conversations between guests and properties."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/messages/conversations","summary":"Retrieve a conversation","prefix":{"name":"post","color":"post"},"badges":[],"link":"/conversations/conversations","deprecated":false}]}]}]}]}},{"type":"group","label":"Messages","link":"/demand/docs/additional-services/messaging/messaging/messages","routeSlug":"/demand/docs/additional-services/messaging/messaging/messages","items":[{"label":"Send a message","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/messages/send","routeSlug":"/demand/docs/additional-services/messaging/messaging/messages/send","metadata":{"seo":{"title":"Send a message","description":"Use this endpoint to send a message to a conversation. You can include plain text and optionally attach a file using an attachment ID from a previous upload."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"send","name":"Send a message","isWebhook":false,"pointer":"/paths/~1messages~1send/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send a message","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to send a message to a conversation. You can include plain text and optionally attach a file using an attachment ID from a previous upload."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1send/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-2","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input-2","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1send/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/send","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input-2","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/send","href":"messages/send","openApiOperationId":"send","summary":"Send a message"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input-2","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-2","exampleIds":["paths/~1messages~1send/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-2","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output-2","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1send/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output-2","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-2","exampleIds":["paths/~1messages~1send/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/send"},{"label":"Retrieve latest messages","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/messages/latest","routeSlug":"/demand/docs/additional-services/messaging/messaging/messages/latest","metadata":{"seo":{"title":"Retrieve latest messages","description":"Use this endpoint to fetch the most recent messages, including messages sent by both the property and the guest. By default, up to 100 messages are returned in reverse chronological order (newest first)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"latest","name":"Retrieve latest messages","isWebhook":false,"pointer":"/paths/~1messages~1latest/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve latest messages","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this endpoint to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fetch the most recent messages"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", including messages sent by both the property and the guest. By default, up to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"100 messages"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are returned in reverse chronological order (newest first)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint is ideal for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Synchronising message threads"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" between your system and the Booking.com platform."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Polling for updates"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to detect new messages since your last request."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1latest/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-3","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input-3","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1latest/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/latest","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input-3","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/latest","href":"messages/latest","openApiOperationId":"latest","summary":"Retrieve latest messages"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input-3","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-3","exampleIds":["paths/~1messages~1latest/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-3","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output-3","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1latest/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output-3","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-3","exampleIds":["paths/~1messages~1latest/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/latest"},{"label":"Confirm message receipt","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/messages/confirm","routeSlug":"/demand/docs/additional-services/messaging/messaging/messages/confirm","metadata":{"seo":{"title":"Confirm message receipt","description":"Use this endpoint to confirm receipt of messages. Confirmation is required in order to receive new messages from POST /messages/latest."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"confirm","name":"Confirm message receipt","isWebhook":false,"pointer":"/paths/~1messages~1latest~1confirm/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Confirm message receipt","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to confirm receipt of messages. Confirmation is required in order to receive new messages from POST /messages/latest."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1latest~1confirm/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-4","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input-4","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1latest~1confirm/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/latest/confirm","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input-4","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/latest/confirm","href":"messages/confirm","openApiOperationId":"confirm","summary":"Confirm message receipt"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input-4","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-4","exampleIds":["paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-4","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output-4","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1latest~1confirm/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output-4","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-4","exampleIds":["paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/latest/confirm"}],"content":{"contentType":"group","meta":{"name":"Messages"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Messages","showPageActions":true},{"nodeType":"markdoc","content":"Send messages, retrieve the latest messages, confirm receipt, and read attachment metadata."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/messages/send","summary":"Send a message","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/send","deprecated":false},{"title":"/messages/latest","summary":"Retrieve latest messages","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/latest","deprecated":false},{"title":"/messages/latest/confirm","summary":"Confirm message receipt","prefix":{"name":"post","color":"post"},"badges":[],"link":"/messages/confirm","deprecated":false}]}]}]}]}},{"type":"group","label":"Attachments","link":"/demand/docs/additional-services/messaging/messaging/attachments","routeSlug":"/demand/docs/additional-services/messaging/messaging/attachments","items":[{"label":"Upload attachment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/attachments/upload","routeSlug":"/demand/docs/additional-services/messaging/messaging/attachments/upload","metadata":{"seo":{"title":"Upload attachment","description":"Use this endpoint to upload a file to be used as a message attachment. The response includes an attachment ID to reference when sending messages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"upload","name":"Upload attachment","isWebhook":false,"pointer":"/paths/~1messages~1attachments~1upload/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Upload attachment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to upload a file to be used as a message attachment. The response includes an attachment ID to reference when sending messages."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1attachments~1upload/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-5","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input-5","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1attachments~1upload/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/attachments/upload","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input-5","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/attachments/upload","href":"attachments/upload","openApiOperationId":"upload","summary":"Upload attachment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input-5","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-5","exampleIds":["paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-5","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output-5","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1attachments~1upload/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output-5","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-5","exampleIds":["paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/attachments/upload"},{"label":"Download attachment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/attachments/download","routeSlug":"/demand/docs/additional-services/messaging/messaging/attachments/download","metadata":{"seo":{"title":"Download attachment","description":"Use this endpoint to retrieve a file that was attached to a message. The response includes the file in a base64-encoded format."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"download","name":"Download attachment","isWebhook":false,"pointer":"/paths/~1messages~1attachments~1download/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download attachment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to retrieve a file that was attached to a message. The response includes the file in a base64-encoded format."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1attachments~1download/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1attachments~1download/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/attachments/download","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/attachments/download","href":"attachments/download","openApiOperationId":"download","summary":"Download attachment"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-6","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output-6","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1attachments~1download/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output-6","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-6","exampleIds":["paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/attachments/download"},{"label":"Retrieve attachment metadata","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/demand/docs/additional-services/messaging/messaging/attachments/metadata","routeSlug":"/demand/docs/additional-services/messaging/messaging/attachments/metadata","metadata":{"seo":{"title":"Retrieve attachment metadata","description":"Use this endpoint to get basic information about an uploaded file, such as its name, type, and size."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"metadata","name":"Retrieve attachment metadata","isWebhook":false,"pointer":"/paths/~1messages~1attachments~1metadata/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve attachment metadata","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Use this endpoint to get basic information about an uploaded file, such as its name, type, and size."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"bearer"}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Affiliate-Id","in":"header","schemaId":"schema_0","description":"Include here your Affiliate identifier number","required":true}],"pointer":"/paths/~1messages~1attachments~1metadata/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1messages~1attachments~1metadata/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/messages/attachments/metadata","servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"X-Affiliate-Id","in":"header","required":true,"schemaId":"schema_0"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/messages/attachments/metadata","href":"attachments/metadata","openApiOperationId":"metadata","summary":"Retrieve attachment metadata"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/input-6","exampleIds":["paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-7","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/output-7","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"]}],"pointer":"/paths/~1messages~1attachments~1metadata/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/output-7","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/output-7","exampleIds":["paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/messages/attachments/metadata"}],"content":{"contentType":"group","meta":{"name":"Attachments"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attachments","showPageActions":true},{"nodeType":"markdoc","content":"Upload and download message attachments."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/messages/attachments/upload","summary":"Upload attachment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attachments/upload","deprecated":false},{"title":"/messages/attachments/download","summary":"Download attachment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attachments/download","deprecated":false},{"title":"/messages/attachments/metadata","summary":"Retrieve attachment metadata","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attachments/metadata","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/conversation":{"id":"components/schemas/conversation","kind":"json-schema","title":"conversation","data":{"description":"A unique identifier for the conversation thread.","type":"string"}},"components/schemas/reservation":{"id":"components/schemas/reservation","kind":"json-schema","title":"reservation","data":{"type":"string","description":"The unique identifier of the reservation"}},"components/schemas/input":{"id":"components/schemas/input","kind":"json-schema","title":"RetrieveConversationRequest","data":{"title":"RetrieveConversationRequest","description":"Provide the accommodation identifier and either a conversation identifier or a reservation identifier.","oneOf":[{"title":"Retrieve by conversation ID","type":"object","required":["accommodation","conversation"],"properties":{"accommodation":{"type":"string","description":"The unique identifier of the property"},"conversation":{"description":"Uniquely identifies the conversation.","$ref":"#/components/schemas/conversation"}}},{"title":"Retrieve by reservation ID","type":"object","required":["accommodation","reservation"],"properties":{"accommodation":{"type":"string","description":"The unique identifier of the property"},"reservation":{"type":"string","description":"Unique identifier of the reservation associated with this conversation.","$ref":"#/components/schemas/reservation"}}}]}},"components/schemas/requestId":{"id":"components/schemas/requestId","kind":"json-schema","title":"requestId","data":{"description":"Uniquely identifies the request. Please provide this identifier when contacting support.","type":"string"}},"components/schemas/timestamp":{"id":"components/schemas/timestamp","kind":"json-schema","title":"timestamp","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The timestamp in ISO-8601 format from which the message is sent. Format: YYYY-MM-DDTHH:mm:ss+00:00"},"children":[]}]}]}],"type":"string","format":"date-time"}},"components/schemas/message":{"id":"components/schemas/message","kind":"json-schema","title":"message","data":{"type":"object","required":["id","sender","content","timestamp"],"properties":{"id":{"type":"string","description":"Unique identifier of the message."},"sender":{"description":"Unique identifier of the sender (either property or guest).","type":"string"},"content":{"type":"string","description":"Message content in plain text."},"attachments":{"type":"array","description":"List of attachment IDs included with the message (if any).","items":{"type":"string"}},"timestamp":{"$ref":"#/components/schemas/timestamp"}}}},"components/schemas/metadata":{"id":"components/schemas/metadata","kind":"json-schema","title":"metadata","data":{"type":"object","properties":{"type":{"description":"Type of the metadata","type":"string","enum":["guest","property"]},"name":{"description":"The display name of the participant, when available.","type":"string"}}}},"components/schemas/participants":{"id":"components/schemas/participants","kind":"json-schema","title":"participants","data":{"type":"object","required":["id","metadata"],"properties":{"id":{"type":"string","description":"Unique identifier of the participant."},"metadata":{"type":"object","$ref":"#/components/schemas/metadata"}}}},"components/schemas/conversation-2":{"id":"components/schemas/conversation-2","kind":"json-schema","title":"conversation-2","data":{"type":"object","required":["id","messages","participants"],"properties":{"id":{"type":"string","description":"Unique identifier of the conversation."},"reservation":{"type":"string","description":"The unique identifier of the reservation","$ref":"#/components/schemas/reservation"},"messages":{"description":"Chronological list of messages in the conversation.","type":"array","items":{"$ref":"#/components/schemas/message"}},"participants":{"type":"array","description":"List of participants in the conversation, including guest and property.","items":{"$ref":"#/components/schemas/participants"}}}}},"components/schemas/output":{"id":"components/schemas/output","kind":"json-schema","title":"output","data":{"type":"object","required":["request_id","data"],"properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","required":["conversation"],"properties":{"conversation":{"type":"object","$ref":"#/components/schemas/conversation-2"}}}}}},"components/schemas/accommodation":{"id":"components/schemas/accommodation","kind":"json-schema","title":"accommodation","data":{"type":"string","description":"The unique identifier of the property"}},"components/schemas/attachment":{"id":"components/schemas/attachment","kind":"json-schema","title":"attachment","data":{"type":"string","description":"The unique identifier of the attachment"}},"components/schemas/input-2":{"id":"components/schemas/input-2","kind":"json-schema","title":"input-2","data":{"type":"object","required":["accommodation","conversation","content"],"properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/accommodation"},"content":{"type":"string","description":"The body of the message."},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/attachment"}}}}},"components/schemas/message-2":{"id":"components/schemas/message-2","kind":"json-schema","title":"message-2","data":{"description":"A unique identifier for the message.","type":"string"}},"components/schemas/output-2":{"id":"components/schemas/output-2","kind":"json-schema","title":"output-2","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/message-2"}}}}}},"components/schemas/input-3":{"id":"components/schemas/input-3","kind":"json-schema","title":"input-3","data":{}},"components/schemas/conversation-3":{"id":"components/schemas/conversation-3","kind":"json-schema","title":"conversation-3","data":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/accommodation"},"reservation":{"type":"string","description":"The unique identifier of the reservation","$ref":"#/components/schemas/reservation"}}}},"components/schemas/metadata-2":{"id":"components/schemas/metadata-2","kind":"json-schema","title":"metadata-2","data":{"type":"object","properties":{"type":{"description":"Specifies the conversation participant type.","type":"string","enum":["guest","property"]},"name":{"description":"The display name of the participant (e.g., guest or property name).","type":"string"}}}},"components/schemas/sender":{"id":"components/schemas/sender","kind":"json-schema","title":"sender","data":{"type":"object","properties":{"participant":{"description":"A unique identifier for the conversation participant.","type":"string"},"metadata":{"type":"object","$ref":"#/components/schemas/metadata-2"}}}},"components/schemas/message-3":{"id":"components/schemas/message-3","kind":"json-schema","title":"message-3","data":{"type":"object","properties":{"conversation":{"type":"object","$ref":"#/components/schemas/conversation-3"},"content":{"type":"string","description":"The body of the message."},"id":{"$ref":"#/components/schemas/message-2"},"sender":{"type":"object","$ref":"#/components/schemas/sender"},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/attachment"}},"timestamp":{"$ref":"#/components/schemas/timestamp"}}}},"components/schemas/output-3":{"id":"components/schemas/output-3","kind":"json-schema","title":"output-3","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"messages":{"type":"array","description":"List of recent messages in reverse chronological order.","items":{"$ref":"#/components/schemas/message-3"}}}}}}},"components/schemas/input-4":{"id":"components/schemas/input-4","kind":"json-schema","title":"ConfirmMessageReceiptRequest","data":{"title":"ConfirmMessageReceiptRequest","type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/message-2"}}}}},"components/schemas/output-4":{"id":"components/schemas/output-4","kind":"json-schema","title":"output-4","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"confirmedMessages":{"type":"array","items":{"$ref":"#/components/schemas/message-2"}}}}},"components/schemas/input-5":{"id":"components/schemas/input-5","kind":"json-schema","title":"input-5","data":{"type":"object","required":["conversation","accommodation","file_size","file_name","file_type","file_content"],"properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/accommodation"},"file_size":{"description":"The file size in bytes.","type":"integer","format":"int64","maximum":1048576},"file_name":{"description":"The original file name including extension.","type":"string"},"file_type":{"description":"The MIME type of the attachment (supported formats: PNG, JPEG, JPG).","type":"string"},"file_content":{"description":"Base64-encoded content of the attachment.","type":"string","contentEncoding":"base64"}}}},"components/schemas/output-5":{"id":"components/schemas/output-5","kind":"json-schema","title":"output-5","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}}}},"components/schemas/input-6":{"id":"components/schemas/input-6","kind":"json-schema","title":"input-6","data":{"type":"object","properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"accommodation":{"type":"string","description":"The unique identifier of the property","$ref":"#/components/schemas/accommodation"},"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}},"components/schemas/output-6":{"id":"components/schemas/output-6","kind":"json-schema","title":"output-6","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"conversation":{"type":"string","description":"The unique identifier of the conversation","$ref":"#/components/schemas/conversation"},"file_content":{"type":"string","description":"The content of the attachment","contentEncoding":"base64"},"attachment":{"type":"string","description":"The unique identifier of the attachment","$ref":"#/components/schemas/attachment"}}}}}},"components/schemas/metadata-3":{"id":"components/schemas/metadata-3","kind":"json-schema","title":"metadata-3","data":{"type":"object","properties":{"file_size":{"description":"The size of the attachment (up to 1MB)","type":"integer","format":"int64","maximum":1048576},"file_name":{"description":"The original file name.","type":"string"},"file_type":{"description":"The MIME type of the attachment. Note only the following image formats are supported: PNG, JPEG, and JPG.","type":"string"}}}},"components/schemas/output-7":{"id":"components/schemas/output-7","kind":"json-schema","title":"output-7","data":{"type":"object","properties":{"request_id":{"$ref":"#/components/schemas/requestId"},"data":{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/metadata-3"}}}}}},"schema_0":{"kind":"json-schema","data":{"type":"integer"},"id":"schema_0"}},"exampleStore":{"paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample":{"value":{"accommodation":"6819547","conversation":"c3cc6522-aa63-559d-99f1-94efdd527c3c"},"key":"conversationExample","summary":"Retrieve a conversation by accommodation and conversation ID","id":"paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/conversationExample"},"paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample":{"value":{"accommodation":"6819547","reservation":"4338284887"},"key":"reservationExample","summary":"Retrieve a conversation by accommodation and reservation ID","id":"paths/~1messages~1conversations/post/requestBody/content/application~1json/examples/reservationExample"},"paths/~1messages~1conversations/post/responses/200/content/application~1json/example":{"value":{"request_id":"7889a8c0-aa43-494c-863d-72d2306849c1","data":{"conversation":{"id":"c3cc6522-aa63-559d-99f1-94efdd527c3c","reservation":"4338284887","messages":[{"id":"af3d7fd0-1c50-11f0-81cd-6d243d208da3","sender":"6c22a16d-a3bd-5f5b-82d9-ce1030f21b1f","content":"Thank you for choosing Demand API Messaging Test Hotel...","attachments":[],"timestamp":"2026-09-18T12:28:51.149Z"}],"participants":[{"id":"5dba2525-2c49-5d2c-91cc-7195526c0c7a","metadata":{"type":"guest"}},{"id":"6c22a16d-a3bd-5f5b-82d9-ce1030f21b1f","metadata":{"type":"property","name":"6819547"}}]}}},"id":"paths/~1messages~1conversations/post/responses/200/content/application~1json/example"},"paths/~1messages~1send/post/requestBody/content/application~1json/example":{"value":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","accommodation":"6819547","content":"Hello! This is my first message","attachments":["c325f460-1dc6-11f0-80f0-8d0908786f77"]},"id":"paths/~1messages~1send/post/requestBody/content/application~1json/example"},"paths/~1messages~1send/post/responses/200/content/application~1json/example":{"value":{"request_id":"cdb0b154-2eae-481b-8fee-fb2725296e1f","data":{"message":"3164e570-19e0-11f0-baca-e5019c8df435"}},"id":"paths/~1messages~1send/post/responses/200/content/application~1json/example"},"paths/~1messages~1latest/post/requestBody/content/application~1json/example":{"value":{},"id":"paths/~1messages~1latest/post/requestBody/content/application~1json/example"},"paths/~1messages~1latest/post/responses/200/content/application~1json/example":{"value":{"request_id":"0248d85a-17e0-44b3-a37c-7d4b5c03f58b","data":{"messages":[{"conversation":{"id":"b2364f9b-6466-599a-a947-0d35cff4f492","reservation":"4439608993","accommodation":"5589515"},"content":"Hello Pega, welcome to CS Training Test Hotel Sloterdijk 10! We’re very happy to have you with us.\\nYour check-in date is : Tuesday 5 August 2025\\nYour check-in time is : 00:00 \\nNumber of nights: 3\\n\nWe hope you have a pleasant trip and enjoy your stay with us.\\n\nBest regards,\nThe CS Training Test Hotel Sloterdijk 10 Team.","id":"52100000-2be9-11f0-bced-bdc849c480b6","sender":{"participant":"930d9af8-2390-5e43-a4d7-235b52a30a14","metadata":{"type":"property","name":"CS Training Test Hotel Sloterdijk 10"}},"attachments":[],"timestamp":"2025-05-08T08:49:15.000Z"}]}},"id":"paths/~1messages~1latest/post/responses/200/content/application~1json/example"},"paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example":{"value":{"messages":["8586a789-44f4-5521-9f27-f5efd097cba"]},"id":"paths/~1messages~1latest~1confirm/post/requestBody/content/application~1json/example"},"paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example":{"value":{"request_id":"cdb0b154-2eae-481b-8fee-fb2725296e1f","confirmedMessages":["8586a789-44f4-5521-9f27-f5efd097cba"]},"id":"paths/~1messages~1latest~1confirm/post/responses/200/content/application~1json/example"},"paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example":{"value":{"accommodation":"6819547","conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","file_size":17580,"file_name":"a3e062a0-3e6b-4592-9df2-64cf83688084.jpg","file_type":"image/jpeg","file_content":"/9j/4AAQSkZJRgABAQACWAJYAAD/2wCEAAgGBgc"},"id":"paths/~1messages~1attachments~1upload/post/requestBody/content/application~1json/example"},"paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example":{"value":{"request_id":"c249e7b6-be70-411b-bcb7-0c2d49313199","data":{"attachment":"695b7f90-2c08-11f0-9cee-134ca9b067d1"}},"id":"paths/~1messages~1attachments~1upload/post/responses/200/content/application~1json/example"},"paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example":{"value":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","accommodation":"6819547","attachment":"9635be40-1dc6-11f0-8893-0130f0cdef6d"},"id":"paths/~1messages~1attachments~1download/post/requestBody/content/application~1json/example"},"paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example":{"value":{"request_id":"773e2c0d-1ab3-449b-b88a-3d6b5ce09ae7","data":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","file_content":"/9j/4AAQSkZJRgABAQACWAJYAAD/2wCEAAgGBgc","attachment":"9635be40-1dc6-11f0-8893-0130f0cdef6d"}},"id":"paths/~1messages~1attachments~1download/post/responses/200/content/application~1json/example"},"paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example":{"value":{"conversation":"8586a789-44f4-5521-9f27-f5efd097cba6","accommodation":"6819547","attachment":"9635be40-1dc6-11f0-8893-0130f0cdef6d"},"id":"paths/~1messages~1attachments~1metadata/post/requestBody/content/application~1json/example"},"paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example":{"value":{"request_id":"fec1a9bb-9c85-42fc-a109-3707e1ed4de7","data":{"metadata":{"file_size":92620,"file_name":"1ce51916-d8de-4144-a4be-265ccae5df9d.jpg","file_type":"image/jpeg"}}},"id":"paths/~1messages~1attachments~1metadata/post/responses/200/content/application~1json/example"}},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"bearer"}},"servers":[{"url":"https://demandapi.booking.com/3.3"},{"url":"https://demandapi-sandbox.booking.com/3.3"}],"specType":"openapi"},"options":{"feedback":{"hide":true,"settings":{"label":""}},"corsProxyUrl":"https://cors.redoc.ly","mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/demand/docs/additional-services/messaging/messaging.json?download"},{"url":"/_bundle/demand/docs/additional-services/messaging/messaging.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Messaging API","description":"The Messaging API lets affiliate partners exchange messages between guests and\nproperties on behalf of their users.\n\nUse it to retrieve conversations, read the latest messages, send new messages,\nconfirm receipt, and upload or download attachments.\n\nAll requests require authentication using your Affiliate identifier\n(`X-Affiliate-Id` header) together with your token credentials.\n"}},"baseSlug":"/demand/docs/additional-services/messaging/messaging","routesMapping":{}}