{"items":[{"type":"link","label":"Charges API","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification","content":{"contentType":"overview","meta":{"name":"Charges API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"charges-api-specification.json","url":"/_bundle/connectivity/docs/openapispecs/charges-api/charges-api-specification.json?download"},{"kind":"download","label":"charges-api-specification.yaml","url":"/_bundle/connectivity/docs/openapispecs/charges-api/charges-api-specification.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://connect.booking.com","url":"https://connect.booking.com"},{"kind":"email","title":"Connectivity Team","email":"connectivity@booking.com","label":"connectivity@booking.com","withCopyButton":true,"copyContent":"connectivity@booking.com"}]},{"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":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Charges API (1.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"Create and update charges that apply at the property and room level, and setup up different configurations for different dates."}],"sectionId":"/connectivity/docs/openapispecs/charges-api/charges-api-specification"}],"sectionId":"/connectivity/docs/openapispecs/charges-api/charges-api-specification"}]}]}},{"type":"separator","label":"API Endpoints","content":null},{"type":"group","label":"Charges endpoint","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-endpoint","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-endpoint","items":[{"label":"Get property and room charges","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-endpoint/getchargesforproperty","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-endpoint/getchargesforproperty","metadata":{"seo":{"title":"Get property and room charges","description":"Retrieve the current charges for a property in format consistent with the creation/update payload."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getChargesForProperty","name":"Get property and room charges","isWebhook":false,"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get property and room charges","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve the current charges for a property in format consistent with the creation/update payload."},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"propertyId","in":"path","schemaId":"schema_454","required":true}],"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/charges-api/properties/{propertyId}/charges","servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"parameters":{"path":[{"name":"propertyId","in":"path","required":true,"schemaId":"schema_454"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/charges-api/properties/{propertyId}/charges","href":"charges-endpoint/getchargesforproperty","openApiOperationId":"getChargesForProperty","summary":"Get property and room charges"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiResponseCharges"}},"schemaId":"components/schemas/ApiResponseCharges"}],"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ApiResponseCharges","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiResponseCharges"}}}],"examples":[]}]}]}]},"httpPath":"/charges-api/properties/{propertyId}/charges"},{"label":"Create, update, and delete property and room charges","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-endpoint/updatechargesforproperty","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-endpoint/updatechargesforproperty","metadata":{"seo":{"title":"Create, update, and delete property and room charges","description":"Add or update taxes and fees at the property or room-level."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateChargesForProperty","name":"Create, update, and delete property and room charges","isWebhook":false,"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create, update, and delete property and room charges","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Add or update taxes and fees at the property or room-level."},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"propertyId","in":"path","schemaId":"schema_454","required":true}],"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Charges","exampleIds":["paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/Charges","exampleIds":["paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/charges-api/properties/{propertyId}/charges","servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"parameters":{"path":[{"name":"propertyId","in":"path","required":true,"schemaId":"schema_454"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/Charges","exampleIds":["paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody/content/application~1json/example"]}},"responseCodes":["200"],"pointer":"/charges-api/properties/{propertyId}/charges","href":"charges-endpoint/updatechargesforproperty","openApiOperationId":"updateChargesForProperty","summary":"Create, update, and delete property and room charges"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"schemaId":"components/schemas/Charges","exampleIds":["paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Charges","exampleIds":["paths/~1charges-api~1properties~1{propertyId}~1charges/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":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiResponseObject"}},"schemaId":"components/schemas/ApiResponseObject"}],"pointer":"/paths/~1charges-api~1properties~1{propertyId}~1charges/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ApiResponseObject","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiResponseObject"}}}],"examples":[]}]}]}]},"httpPath":"/charges-api/properties/{propertyId}/charges"}],"content":{"contentType":"group","meta":{"name":"Charges endpoint"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Charges endpoint","showPageActions":true},{"nodeType":"markdoc","content":"Lists the details of the Charges endpoints to set and retrieve taxes and fees at the property and room level."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/charges-api/properties/{propertyId}/charges","summary":"Get property and room charges","prefix":{"name":"get","color":"get"},"badges":[],"link":"/charges-endpoint/getchargesforproperty","deprecated":false},{"title":"/charges-api/properties/{propertyId}/charges","summary":"Create, update, and delete property and room charges","prefix":{"name":"post","color":"post"},"badges":[],"link":"/charges-endpoint/updatechargesforproperty","deprecated":false}]}]}]}]}},{"type":"group","label":"Charges meta endpoint","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-meta-endpoint","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-meta-endpoint","items":[{"label":"Retrieve Charges meta information","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-meta-endpoint/meta","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/charges-meta-endpoint/meta","metadata":{"seo":{"title":"Retrieve Charges meta information","description":"Retrieve a full list of charge types supported by the Charges API. The API returns: Charge type names translated in the specified languageTheir corresponding OTA codes The charge category each type belongs to"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"meta","name":"Retrieve Charges meta information","isWebhook":false,"pointer":"/paths/~1charges-api~1meta/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve Charges meta information","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":"Retrieve a full list of charge types supported by the Charges API. The API returns: "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"ul","attrs":{}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Charge type names translated in the specified language"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Their corresponding OTA codes "},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charge category each type belongs to"},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"language_code","in":"query","schemaId":"schema_455","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Language code for localization. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"EN_GB"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"pointer":"/paths/~1charges-api~1meta/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/charges-api/meta","servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"parameters":{"path":[],"query":[{"name":"language_code","in":"query","required":false,"schemaId":"schema_455"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/charges-api/meta","href":"charges-meta-endpoint/meta","openApiOperationId":"meta","summary":"Retrieve Charges meta information"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","description":"Mock (schema only)","isMockServer":true},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiResponseListChargeTypeMetaEntry"}},"schemaId":"components/schemas/ApiResponseListChargeTypeMetaEntry"}],"pointer":"/paths/~1charges-api~1meta/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ApiResponseListChargeTypeMetaEntry","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiResponseListChargeTypeMetaEntry"}}}],"examples":[]}]}]}]},"httpPath":"/charges-api/meta"}],"content":{"contentType":"group","meta":{"name":"Charges meta endpoint"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Charges meta endpoint","showPageActions":true},{"nodeType":"markdoc","content":"Lists the details of the Charges meta endpoint to retrieve a full list of charge types supported by the Charges API."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/charges-api/meta","summary":"Retrieve Charges meta information","prefix":{"name":"get","color":"get"},"badges":[],"link":"/charges-meta-endpoint/meta","deprecated":false}]}]}]}]}},{"type":"separator","label":"Documentation","content":null},{"type":"group","label":"About Try it","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it","items":[{"type":"link","label":"Environment","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/environment","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/environment","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Environment"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/environment"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environment"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can select between two different environments (top right corner in the UI):"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","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":"Mock (schema only)"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default):"},"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":"text","inline":true,"attributes":{"content":"Helps to understand the response data schema"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Recommended for all write operations (POST, PUT, DELETE)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environment for testing without affecting live/test data"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","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":"Test live endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"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":"text","inline":true,"attributes":{"content":"Make sure to use only test properties."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Changes will affect your test property data"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Requires valid credentials"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Same API structure as production"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Request","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/request","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/request","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Request"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/request"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can click on any unresolved placeholders to add a value or edit an existing placeholder value."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The portal loads the default request body. Where the specification supports multiple request body examples (for example: Rooms API POST endpoint), you can choose a different request body from the drop-down list."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Some helpful pointers before running a request:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","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":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (when using live endpoint): Configure your authentication headers"},"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":"text","inline":true,"attributes":{"content":"API Key or OAuth token as required. Use the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" tab."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Make sure to manage separate machine accounts for test vs. properties in production."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ensure credentials match your selected environment."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","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":"Parameters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Fill in required parameters"},"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":"text","inline":true,"attributes":{"content":"Path parameters (like "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"propertyId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Query parameters (like "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"language_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request body for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST/PUT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operations"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","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":"Execute"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Click "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to send the request"},"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":"text","inline":true,"attributes":{"content":"The request is sent to the selected environment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When sending requests to the live endpoint, real HTTP request is made to the API"},"children":[]}]}]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Response","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/response","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/response","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Response"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/response"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Try it feature provides comprehensive response information to the extent supported by the Open API specification:"},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Status code","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/status-code","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/status-code","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Status code"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/status-code"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status code"},"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":"2xx"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Success responses (200)"},"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":"4xx"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Client errors (400 Bad Request, 401 Unauthorized, 404 Not Found)"},"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":"5xx"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Server errors (500 Internal Server Error)"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Response body","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/response-body","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/response-body","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Response body"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/response-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response body"},"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":"text","inline":true,"attributes":{"content":"JSON formatted response data"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the returned response, by default, is unformatted, select the supported Response body format in the UI."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Response headers","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/response-headers","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/response-headers","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Response headers"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/response-headers"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response headers"},"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":"text","inline":true,"attributes":{"content":"Content-Type, Content-Length."},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Environments","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/environments","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/environments","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Environments"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/environments"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environments"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" tab allows you to create variables specific to the environment. For example, you can add a variable to hold the value of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"property-id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" placeholder. The portal inserts the respective value depending on the environment at the time of sending the request."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Variables","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/variables","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/variables","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Variables"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/variables"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Variables"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Most of the endpoints (especially POST/PUT/DELETE) require you to add a path or query parameter before sending the request. The Open API specification marks these parameters with placeholder tags. For example, {{"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"property_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"}}. You can use the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Environments"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" tab to manage the values for these placeholders as variables."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Path parameters","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/path-parameters","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/path-parameters","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Path parameters"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"about-try-it/path-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Path parameters"},"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":"Required"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Must be provided to make the request"},"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":"Type validation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Ensures correct data types (integer, string, etc.)"},"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":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"propertyId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/charges-api/properties/{propertyId}/charges"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Query parameters","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/query-parameters","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/query-parameters","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Query parameters"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"about-try-it/query-parameters"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Query parameters"},"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":"Optional"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Usually have default values"},"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":"Example"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"language_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-us"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the default value"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Request body","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/request-body","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/request-body","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Request body"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":4,"id":"about-try-it/request-body"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request body"},"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":"Schema validation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Follows OpenAPI schema definitions"},"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":"Example data"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Prepopulated with sample values"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Best practices","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/best-practices","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/best-practices","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Best practices"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/best-practices"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Best practices"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This section provides some basic practice guidelines."},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Authentication","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/authentication","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/authentication","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Authentication"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"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":"text","inline":true,"attributes":{"content":"Always use separate machine accounts for test properties vs. properties in production."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When testing with production endpoint, make sure to use only test properties."},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"For Read operations (GET)","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/for-read-operations-(get)","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/for-read-operations-(get)","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"For Read operations (GET)"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/for-read-operations-(get)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For Read operations (GET)"},"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":"text","inline":true,"attributes":{"content":"Safe to test in any environment"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use valid IDs that exist in your system"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check response structure for integration planning"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"For Write operations (POST, PUT)","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/for-write-operations-(post-put)","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/for-write-operations-(post-put)","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"For Write operations (POST, PUT)"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/for-write-operations-(post-put)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For Write operations (POST, PUT)"},"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":"Always use Mock (schema only) environment first"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify request payload structure"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check response for success confirmation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Test error scenarios with invalid data"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"For Delete operations (DELETE)","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/for-delete-operations-(delete)","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/for-delete-operations-(delete)","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"For Delete operations (DELETE)"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/for-delete-operations-(delete)"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For Delete operations (DELETE)"},"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":"Preferable to use Mock (schema only) environment only"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Understand the operation is irreversible"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Have backup data when testing using test properties"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Troubleshooting","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/troubleshooting","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/troubleshooting","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Troubleshooting"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"about-try-it/troubleshooting"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Troubleshooting"},"children":[]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Common issues","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/common-issues","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/common-issues","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Common issues"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/common-issues"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Common issues"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","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":"401 Unauthorized"},"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":"text","inline":true,"attributes":{"content":"Check authentication credentials"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify API key is valid and not expired"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ensure credentials match the selected environment"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","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":"400 Bad Request"},"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":"text","inline":true,"attributes":{"content":"Validate request payload against schema"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check required fields are provided"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify data types match specification"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","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":"404 Not Found"},"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":"text","inline":true,"attributes":{"content":"Confirm the resource ID exists"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check the endpoint URL is correct"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify you have access to the resource"},"children":[]}]}]}]}]}],"panels":[]}]}},{"type":"link","label":"Getting help","link":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/getting-help","routeSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification/about-try-it/getting-help","content":{"contentType":"item","itemVariant":"markdown","meta":{"name":"Getting help"},"children":[{"nodeType":"container","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"about-try-it/getting-help"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Getting help"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you encounter issues:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Check the response error message for details"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify your request matches the API specification"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contact the Connectivity Team for support"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"hr","attributes":{},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This documentation applies to all endpoints in the Charges API. The Try it feature provides a consistent testing experience across all operations."},"children":[]}]}]}]}]}],"panels":[]}]}}],"content":{"contentType":"group","meta":{"name":"About Try it"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"About Try it","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Learn how to effectively use the Try it feature in the Charges API documentation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try it"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" feature to send sample requests to API endpoints directly from the developer portal. In the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mock (schema only)"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" environment, Try it returns schema-driven mock responses or pre-built example responses. In the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Production"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" environment, it sends the request to the live API and returns dynamic responses from your selected test property."},"children":[]}]}]}]}],"panels":[]}]}}],"store":{"schemaStore":{"components/schemas/AgeMultiplier":{"id":"components/schemas/AgeMultiplier","kind":"json-schema","title":"AgeMultiplier","data":{"required":["lte","multiplier"],"type":"object","properties":{"multiplier":{"type":"number","description":"Multiplier to be applied to the amount of the charge if age condition matches.\n\nRequired when including an age configuration.\n\nHDCN:N/A\n"},"lte":{"type":"integer","description":"Upper bound of the age range. Inclusive. Abbreviation for less than or equal to.\n\nHDCN:N/A\n","format":"int32"}},"description":"Contains modifiers for the charge amount based on children ages.\n\nIf multiple modifiers are configured, only the most specific age multiplier that matches the child's age is applied. For example, if a .50 multiplier is configured for children under 8 years old, and a .80 multiplier is configured for children under 12 years old, a 7 year old child would get a .50 discount.\n"}},"components/schemas/Amount":{"id":"components/schemas/Amount","kind":"json-schema","title":"Amount","data":{"required":["mode"],"type":"object","properties":{"value":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Value of the charge."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required unless mode is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INCALCULABLE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", in which case any value passed is ignored."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Interpreted as an absolute value or percentage depending on mode. Absolute values are in the property's configured currency."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN:FeePolicy->Amount AND FeePolicy->Percent"},"children":[]}]}]}]},"base":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies what value the percentage applies to. For example, 10% of NET_ROOM_PRICE + PROPERTY_CHARGES."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when mode is PERCENTAGE (otherwise rejected)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To know what charge types fall into each base category please use the meta endpoint."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Currently we only accept the following combinations:"},"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":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\"]"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\", \"PROPERTY_CHARGES\"]"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\", \"LOCALITY_CHARGES\"]"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\", \"LOCALITY_CHARGES\", \"PROPERTY_CHARGES\"]"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN: N/A"},"children":[]}]}]}],"items":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies what value the percentage applies to. For example, 10% of NET_ROOM_PRICE + PROPERTY_CHARGES."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when mode is PERCENTAGE (otherwise rejected)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To know what charge types fall into each base category please use the meta endpoint."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Currently we only accept the following combinations:"},"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":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\"]"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\", \"PROPERTY_CHARGES\"]"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\", \"LOCALITY_CHARGES\"]"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"[\"NET_ROOM_PRICE\", \"LOCALITY_CHARGES\", \"PROPERTY_CHARGES\"]"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN: N/A"},"children":[]}]}]}],"enum":["NET_ROOM_PRICE","TAXES","LOCALITY_CHARGES","PROPERTY_CHARGES","FACILITY_CHARGES"]}},"mode":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The mode used for this charge."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reference the meta endpoint to understand which charge modes are supported for the charge type."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN:FeePolicy->ChargeFrequency AND FeePolicy->Percent in the case of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PERCENTAGE"},"children":[]}]}]}],"enum":["PER_NIGHT","PER_STAY","PER_PERSON_PER_NIGHT","PER_PERSON_PER_STAY","PERCENTAGE","INCALCULABLE"]}},"description":"Contains details about the charge price."}},"components/schemas/ApplicableWindow":{"id":"components/schemas/ApplicableWindow","kind":"json-schema","title":"ApplicableWindow","data":{"required":["from"],"type":"object","properties":{"from":{"type":"string","description":"The start date for this charge period. The date is relative to the timezone of the property. If you are modifying an existing active charge, this date may be in the past if it matches the active charge's date.\n\nFormat: ISO 8601 date (YYYY-MM-DD)\n\nCharge periods with a start date more than 10 years in the future will be ignored, effectively making the charge extend indefinitely.\n\nHDCN: N/A\n"},"to":{"type":"string","description":"The end date for this charge period (inclusive). The date is relative to the timezone of the property. If null or undefined the current charge period extends forever.\n\nFormat: ISO 8601 date (YYYY-MM-DD)\n\nCharge periods with an end date more than 10 years in the future will be created without an end date, effectively making the charge extend indefinitely.\n\nHDCN: N/A\n"}},"description":"The date range for this charge period. Dates are inclusive and must not overlap."}},"components/schemas/Charge":{"id":"components/schemas/Charge","kind":"json-schema","title":"Charge","data":{"required":["charge_key","charge_periods"],"type":"object","properties":{"charge_key":{"$ref":"#/components/schemas/ChargeKey"},"charge_periods":{"type":"array","description":"Contains the timeline of various configurations for the charge through time.","items":{"$ref":"#/components/schemas/ChargePeriod"}}},"description":"List of charges for the room."}},"components/schemas/ChargeConfiguration":{"id":"components/schemas/ChargeConfiguration","kind":"json-schema","title":"ChargeConfiguration","data":{"required":["amount","excluded"],"type":"object","properties":{"amount":{"$ref":"#/components/schemas/Amount"},"child_ages":{"type":"array","description":"Contains modifiers for the charge amount based on children ages.\n\nIf multiple modifiers are configured, only the most specific age multiplier that matches the child's age is applied. For example, if a .50 multiplier is configured for children under 8 years old, and a .80 multiplier is configured for children under 12 years old, a 7 year old child would get a .50 discount.\n","items":{"$ref":"#/components/schemas/AgeMultiplier"}},"excluded":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies if the charge is included or excluded from the calendar rate."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, let's assume the calendar rate is set to 100 euros. If there is a 10 euro excluded charge the net price would be 110 euros and our price breakdown would show 100 + 10. If the 10 euro charge is not excluded the net price would be 100 and our price breakdown would show 90 + 10."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This corresponds to the similarly named field in extranet, but is separate from the included/excluded within Reservations API."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN: FeePolicy->Type"},"children":[]}]}]}]}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The charge configuration for this period."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If specified as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" it clears the charge for the specific period. This field cannot be omitted."},"children":[]}]}]}]}},"components/schemas/ChargeKey":{"id":"components/schemas/ChargeKey","kind":"json-schema","title":"ChargeKey","data":{"required":["guest_origin","travel_purpose","type"],"type":"object","properties":{"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of charge. For a mapping between OTA/legacy and the new codes please use the meta endpoint."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN: FeePolicy->Code"},"children":[]}]}]}],"enum":["SERVICECHARGE_ASIA","SERVICECHARGE","RESORTFEE","CLEANINGFEE","TOWELFEE","ELECTRICITYFEE","BEDLINEN","GASFEE","OILFEE","WOODFEE","WATERFEE","TRANSFERFEE","LINENPACKAGEFEE","HEATINGFEE","AIRCONDITIONINGFEE","KITCHENLINNENFEE","HOUSEKEEPINGFEE","AIRPORTSHUTTLEFEE","SHUTTLEBOATFEE","GALADINNERFEE","SEAPLANEFEE","SKIPASS","FINALCLEANINGFEE","WRISTBANDFEE","VISASUPPORTFEE","WATERPARKFEE","CLUBCARDFEE","CONSERVATIONFEE","CREDITCARDFEE","PETFEE","INTERNETFEE","PARKINGFEE","VAT","TAX","GOODSSERVICESTAX","GOODSSERVICESFLOODTAX","GOVERNMENTCHARGE","DAMAGEDEPOSIT","DESTINATIONFEE","ENVIRONMENTFEE","SPATAX","CITYTAX","HOTSPRINGTAX","MUNICIPALITYFEE","TOURISMFEE","RESIDENTIALTAX","CITYTICKET","HERITAGECHARGE","FITNESSTAX","GOVERNMENTTAX","LOCALCOUNCILTAX","SUSTAINABILITYFEE","LOCALITYCONSERVATIONFEE","SPA","HOTSPRINGBATH","POOL","LOUNGE","DESTINATIONCHARGE","DESTINATIONTAX","INSURANCEFEE"]},"guest_origin":{"type":"string","description":"The guest origin as specified when they make the booking.\n\nWhen determining which charges to apply at checkout, the narrowest/most specific charge key is used. For example if an INTERNATIONAL guest books at a property that has both an INTERNATIONAL and ANY charge key (with the same charge type), only the INTERNATIONAL charge is applied.\n\nHDCN: N/A\n","enum":["ANY","DOMESTIC","INTERNATIONAL"]},"travel_purpose":{"type":"string","description":"The travel purpose as specified by the guest when they make the booking.\n\nWhen determining which charge to use at checkout, the narrowest/most specific charge key is used. For example if an LEISURE guest books at a property that has both an LEISURE and ANY charge key (with the same charge type), only the LEISURE charge is applied.\n\nHDCN: N/A\n","enum":["ANY","LEISURE","BUSINESS"]}},"description":"Contains the attributes that uniquely identify a charge.\n\nIf you change an attribute in the charge key, you are modifying a different charge with its own charge periods."}},"components/schemas/ChargePeriod":{"id":"components/schemas/ChargePeriod","kind":"json-schema","title":"ChargePeriod","data":{"required":["applicable"],"type":"object","properties":{"applicable":{"$ref":"#/components/schemas/ApplicableWindow"},"configuration":{"$ref":"#/components/schemas/ChargeConfiguration"}},"description":"Contains the timeline of various configurations for the charge through time."}},"components/schemas/Charges":{"id":"components/schemas/Charges","kind":"json-schema","title":"Charges","data":{"type":"object","properties":{"property_charges":{"type":"array","description":"Charges that apply across the property. Update requests must contain at least one charge between property and room arrays.","items":{"$ref":"#/components/schemas/Charge"}},"room_charges":{"type":"array","description":"Room specific charges. Will override the same charge specified at the property level. Update requests must contain at least one charge between property and room arrays.","items":{"$ref":"#/components/schemas/RoomCharges"}}}}},"components/schemas/RoomCharges":{"id":"components/schemas/RoomCharges","kind":"json-schema","title":"RoomCharges","data":{"required":["charges","room_id"],"type":"object","properties":{"room_id":{"maximum":4294967295,"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Room ID the charges apply to."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HDCN: FeePolicy->InvCode"},"children":[]}]}]}],"format":"int64"},"charges":{"type":"array","description":"List of charges for the room.","items":{"$ref":"#/components/schemas/Charge"}}},"description":"Room specific charges. Will override the same charge specified at the property level. Update requests must contain at least one charge between property and room arrays."}},"components/schemas/ApiError":{"id":"components/schemas/ApiError","kind":"json-schema","title":"ApiError","data":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object"}}}},"components/schemas/ApiResponseObject":{"id":"components/schemas/ApiResponseObject","kind":"json-schema","title":"ApiResponseObject","data":{"type":"object","properties":{"warnings":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}},"components/schemas/ResponseMeta":{"id":"components/schemas/ResponseMeta","kind":"json-schema","title":"ResponseMeta","data":{"type":"object","properties":{"ruid":{"type":"string"}}}},"components/schemas/ApiResponseCharges":{"id":"components/schemas/ApiResponseCharges","kind":"json-schema","title":"ApiResponseCharges","data":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Charges"},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}},"components/schemas/ApiResponseListChargeTypeMetaEntry":{"id":"components/schemas/ApiResponseListChargeTypeMetaEntry","kind":"json-schema","title":"ApiResponseListChargeTypeMetaEntry","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChargeTypeMetaEntry"}},"warnings":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ApiError"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}}}},"components/schemas/ChargeTypeMetaEntry":{"id":"components/schemas/ChargeTypeMetaEntry","kind":"json-schema","title":"ChargeTypeMetaEntry","data":{"type":"object","properties":{"charge_type_id":{"type":"string","description":"Booking.com Charge Type ID","enum":["SERVICECHARGE_ASIA","SERVICECHARGE","RESORTFEE","CLEANINGFEE","TOWELFEE","ELECTRICITYFEE","BEDLINEN","GASFEE","OILFEE","WOODFEE","WATERFEE","DESTINATIONFEE","ENVIRONMENTFEE","SPATAX","TRANSFERFEE","VAT","CITYTAX","TAX","DAMAGEDEPOSIT","LINENPACKAGEFEE","HEATINGFEE","AIRCONDITIONINGFEE","KITCHENLINNENFEE","HOUSEKEEPINGFEE","CLUBCARDFEE","PETFEE","INTERNETFEE","PARKINGFEE","HOTSPRINGTAX","MUNICIPALITYFEE","TOURISMFEE","RESIDENTIALTAX","GOODSSERVICESTAX","HERITAGECHARGE","GOVERNMENTTAX","LOCALCOUNCILTAX","GOVERNMENTCHARGE","LOCALITYCONSERVATIONFEE","INSURANCEFEE","AIRPORTSHUTTLEFEE","SHUTTLEBOATFEE","GALADINNERFEE","SEAPLANEFEE","SKIPASS","FINALCLEANINGFEE","WRISTBANDFEE","VISASUPPORTFEE","WATERPARKFEE","CONSERVATIONFEE","CREDITCARDFEE","CITYTICKET","FITNESSTAX","GOODSSERVICESFLOODTAX","SUSTAINABILITYFEE","SPA","HOTSPRINGBATH","POOL","LOUNGE","DESTINATIONCHARGE","DESTINATIONTAX"]},"charge_type_name":{"type":"string","description":"Booking.com Charge Type name"},"ota_fee_tax_types":{"type":"array","description":"Legacy OTA Fee Tax Type Codes (FTT). In rare cases there are two historical type codes for one modern type.","items":{"type":"integer","description":"Legacy OTA Fee Tax Type Codes (FTT). In rare cases there are two historical type codes for one modern type.","format":"int32"}},"booking_extended_legacy_code":{"type":"array","description":"Legacy Booking.com Extended Fee Tax Type Codes (FTT).","items":{"type":"integer","description":"Legacy Booking.com Extended Fee Tax Type Codes (FTT).","format":"int32"}},"charge_category":{"type":"string","description":"Charge category as used in the charge configuration base","enum":["NET_ROOM_PRICE","TAXES","LOCALITY_CHARGES","PROPERTY_CHARGES","FACILITY_CHARGES"]},"discontinuation_notice":{"type":"string","description":"In the case that a charge type is discontinued, this will provide information about what to use instead or why it was discontinued.\n"},"allowed_charge_modes":{"type":"array","description":"Lists the modes that this charge type supports.\n","items":{"type":"string","description":"Lists the modes that this charge type supports.\n","enum":["PER_NIGHT","PER_STAY","PER_PERSON_PER_NIGHT","PER_PERSON_PER_STAY","PERCENTAGE","INCALCULABLE"]}},"discontinued":{"type":"boolean"}}}},"schema_454":{"kind":"json-schema","data":{"type":"integer","format":"int32"},"id":"schema_454"},"schema_455":{"kind":"json-schema","data":{"type":"string","enum":["EN_GB","EN_US","DE","NL","FR","ES","ES_AR","ES_MX","CA","IT","PT_PT","PT_BR","NO","FI","SV","DA","CS","HU","RO","JA","ZH_CN","ZH_TW","PL","EL","RU","TR","BG","AR","KA","KO","HE","LV","UK","ID","MS","TH","ET","HR","LT","SK","SR","SL","VI","TL","IS","HI","SQ"]},"id":"schema_455"}},"exampleStore":{"paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody/content/application~1json/example":{"value":{"property_charges":[{"charge_key":{"type":"CLEANINGFEE","guest_origin":"ANY","travel_purpose":"ANY"},"charge_periods":[{"applicable":{"from":"2025-11-30"},"configuration":{"amount":{"value":20,"base":[],"mode":"PER_STAY"},"excluded":true}}]}],"room_charges":[]},"id":"paths/~1charges-api~1properties~1{propertyId}~1charges/post/requestBody/content/application~1json/example"}},"securitySchemeStore":{},"servers":[{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","isMockServer":true,"description":"Mock (schema only)"},{"url":"https://supply-xml.booking.com/","description":"Test using live endpoint"}]},"options":{"feedback":{"hide":true,"settings":{"label":""}},"corsProxyUrl":"https://cors.redoc.ly","pagination":"section","hideSidebar":true,"mockServer":{"url":"/_mock/connectivity/docs/openapispecs/charges-api/charges-api-specification","position":"first","description":"Mock (schema only)","off":false},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/connectivity/docs/openapispecs/charges-api/charges-api-specification.json?download"},{"url":"/_bundle/connectivity/docs/openapispecs/charges-api/charges-api-specification.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Charges API","description":"Create and update charges that apply at the property and room level, and setup up different configurations for different dates."}},"baseSlug":"/connectivity/docs/openapispecs/charges-api/charges-api-specification","routesMapping":{}}