Buyer API (Pull)
...
Occupancy Base Rates
Search by Country
1 min
{ "name" "search by country", "method" "post", "url" "https //wspull bakuun com/{version}/mpsoccupancy/{partnercode}/xxxxxx", "description" "search availability and rates for one or more properties using country parameters \nsupports multi room (occupancy based) queries and returns results only for properties that pass system validation and configuration limits ", "tab" "examples", "examples" { "languages" \[ { "id" "qllozck9say11bc e7lqo", "language" "json", "code" "{\n \\"username\\" \\"xxxx\\",\n \\"password\\" \\"xxxx\\",\n \\"partnerid\\" \\"xxxx\\",\n \\"multisearchbycounty\\" {\n \\"countryname\\" \\"xxxx\\"\n },\n \\"checkindate\\" \\"yyyy mm dd\\",\n \\"checkoutdate\\" \\"yyyy mm dd\\"\n \\"ratesbyoccupancy\\" {\n \\"occupancies\\" \[\n {\n \\"occupancyrefid\\" 1,\n \\"numberofadults\\" 2,\n \\"numberofchildren\\" 2,\n \\"childrenblocks\\" \[\n {\n \\"childblock\\" 1,\n \\"numberofchildren\\" 1,\n \\"childrenages\\" \\"1\\"\n },\n {\n \\"childblock\\" 2,\n \\"numberofchildren\\" 1,\n \\"childrenages\\" \\"3\\"\n }\n ]\n }\n ]\n }\n}", "customlabel" "" } ], "selectedlanguageid" "qllozck9say11bc e7lqo" }, "results" { "languages" \[ { "id" "j3bk 3qtul8wzeemnns7g", "language" "200", "code" "{\n \\"success\\" true,\n \\"tokenid\\" \\"82f3797770137851975777f0b799aace\\",\n \\"errors\\" \[]\n}", "customlabel" "" }, { "id" "umzmkdiwnlnqzifldf5 5", "language" "410", "code" "{\n \\"success\\" false,\n \\"tokenid\\" \\"0c80223718e9d240cd607ca9268190a9\\",\n \\"errors\\" {\n \\"success\\" false,\n \\"errors\\" {\n \\"code\\" 410,\n \\"message\\" \\"unauthorized user\\"\n },\n \\"data\\" \[]\n },\n \\"data\\" \[]\n}", "customlabel" "" } ], "selectedlanguageid" "umzmkdiwnlnqzifldf5 5" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "username", "kind" "required", "type" "string", "description" "system generated, api access secret key (unique per account) ", "" "system generated, api access secret key (unique per account) " }, { "name" "password", "kind" "required", "type" "string", "description" "system generated, api access secret key (unique per account) ", "" "system generated, api access secret key (unique per account) " }, { "name" "partnerid", "kind" "required", "type" "string", "description" "partner (buyer) identifier (e g rdkxx mpbxxx) ", "" "partner (buyer) identifier (e g rdkxx mpbxxx) " }, { "name" "multisearchbycounty", "kind" "required", "type" "object", "description" "", "" "multisearchbycounty", "children" \[ { "name" "countryname", "kind" "required", "type" "string", "description" "country associated within the search" } ], "schema" \[ { "name" "countryname", "kind" "required", "type" "string", "description" "country associated within the search" } ] }, { "name" "checkindate", "kind" "required", "type" "string", "description" "iso check in date (e g , 2025 10 05) ", "" "iso check in date (e g , 2025 10 05) " }, { "name" "checkoutdate", "kind" "required", "type" "string", "description" "iso check out date (e g , 2025 10 05) ", "" "iso check out date (e g , 2025 10 05) " }, { "name" "ratesbyoccupancy", "kind" "required", "type" "object", "description" "", "" "required", "children" \[ { "name" "occupancies", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "occupancyrefid", "kind" "required", "type" "integer", "description" "progressive room number starts at 1 (room 1 → 1, room 2 → 2…)\nidentifies which room the configuration refers to \n\nif user searches 3 rooms →\noccupancyrefid 1, occupancyrefid 2, occupancyrefid 3 " }, { "name" "numberofadults", "kind" "required", "type" "integer", "description" "range 1–20" }, { "name" "numberofchildren", "kind" "required", "type" "integer", "description" "if 0, childrenblocks must not be sent\n\ntotal children per room cannot exceed 20" }, { "name" "childrenblocks", "kind" "required", "type" "object", "description" "progressive block identifier ", "children" \[ { "name" "childblock", "kind" "required", "type" "integer", "description" "returned only if numberofchildren > 0\n\neach block represents children grouped by the same age for the same occupancyrefid" }, { "name" "numberofchildren", "kind" "required", "type" "integer", "description" "number of children for this age group " }, { "name" "childrenages", "kind" "required", "type" "integer", "description" "children age range 0–17" } ] } ] } ], "schema" \[ { "name" "occupancies", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "occupancyrefid", "kind" "required", "type" "integer", "description" "progressive room number starts at 1 (room 1 → 1, room 2 → 2…)\nidentifies which room the configuration refers to \n\nif user searches 3 rooms →\noccupancyrefid 1, occupancyrefid 2, occupancyrefid 3 " }, { "name" "numberofadults", "kind" "required", "type" "integer", "description" "range 1–20" }, { "name" "numberofchildren", "kind" "required", "type" "integer", "description" "if 0, childrenblocks must not be sent\n\ntotal children per room cannot exceed 20" }, { "name" "childrenblocks", "kind" "required", "type" "object", "description" "progressive block identifier ", "children" \[ { "name" "childblock", "kind" "required", "type" "integer", "description" "returned only if numberofchildren > 0\n\neach block represents children grouped by the same age for the same occupancyrefid" }, { "name" "numberofchildren", "kind" "required", "type" "integer", "description" "number of children for this age group " }, { "name" "childrenages", "kind" "required", "type" "integer", "description" "children age range 0–17" } ] } ] } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false }

