---
title: Search by Country
slug: 6ne6-search-by-country
docTags: 
createdAt: 2025-10-10T07:33:52.818Z
---

:::ApiMethodV2
```json
{
  "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\": \"020c092935b42e9dde4b37bba95d9080\",\n    \"errors\": [\n        {\n            \"code\": 410,\n            \"message\": \"Unauthorized user\"\n        }\n    ]\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": "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 be Empty Array 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 be Empty Array 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,
  "response": [
    {
      "name": "success",
      "kind": "optional",
      "type": "boolean",
      "description": ""
    },
    {
      "name": "tokenId",
      "kind": "optional",
      "type": "string",
      "description": "",
      "children": []
    },
    {
      "name": "errors",
      "kind": "optional",
      "type": "array",
      "description": "",
      "children": []
    }
  ],
  "autoGeneratedAnchorSlug": "search-by-country",
  "legacyHash": "7fNdleIPgKHGZtCdadS2q"
}
```
:::