Buyer API (Pull)
...
Room Based Rates
Search by ID
1 min
{ "name" "search by id", "method" "post", "url" "https //wspull bakuun com/{version}/mpsnight/{partnercode}/538139", "description" "search availability and rates for one or more properties using their property ids \nsupports multi room (room 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\\" \\"xxxxxx\\",\n \\"password\\" \\"xxxxxx\\",\n \\"partnerid\\" \\"rdkxx\\",\n \\"multisearchbyids\\" {\n \\"propertyids\\" \[\n \\"htlx x\\",\n \\"htlx x\\"\n ]\n },\n \\"checkindate\\" \\"yyyy mm dd\\",\n \\"checkoutdate\\" \\"yyyy mm dd\\",\n \\"ratesbynight\\" {\n \\"occupancies\\" \[\n {\n \\"occupancyrefid\\" 1,\n \\"numberofadults\\" 2\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" "401", "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" "j3bk 3qtul8wzeemnns7g" }, "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" "multisearchbyids", "kind" "required", "type" "object", "description" "", "" "object", "children" \[ { "name" "propertyids", "kind" "optional", "type" "array", "description" "accepted format htlxxx y (example htl123 1) or htlxxxx (example htl1231)\n\nuser may send up to 1000 ids, but system honors max allowed value set in the buyer account configuration \nif limit = 200, and the user sends 1000, only the first 200 are processed; the rest are returned as errors ", "children" \[] } ], "schema" \[ { "name" "propertyids", "kind" "optional", "type" "array", "description" "accepted format htlxxx y (example htl123 1) or htlxxxx (example htl1231)\n\nuser may send up to 1000 ids, but system honors max allowed value set in the buyer account configuration \nif limit = 200, and the user sends 1000, only the first 200 are processed; the rest are returned as errors ", "children" \[] } ] }, { "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" "ratesbynight", "kind" "required", "type" "object", "description" "", "" "object", "children" \[ { "name" "occupancies", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "occupancyrefid", "kind" "required", "type" "number", "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 \n" }, { "name" "numberofadults", "kind" "required", "type" "number", "description" "must a number between 1 to 20 " } ] } ], "schema" \[ { "name" "occupancies", "kind" "required", "type" "object", "description" "", "children" \[ { "name" "occupancyrefid", "kind" "required", "type" "number", "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 \n" }, { "name" "numberofadults", "kind" "required", "type" "number", "description" "must a number between 1 to 20 " } ] } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false }

