---
title: Search by Geo
slug: Labf-search-by-geo
docTags: 
createdAt: 2025-10-10T07:33:52.818Z
---

:::ApiMethodV2
```json
{
  "name": "Search by Geo",
  "method": "POST",
  "url": "https://wspull.bakuun.com/{version}/mpsnight/{PartnerCode}/538139",
  "description": "Search availability and rates for one or more properties using latitude and longitude parameters.\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\": \"xxxx\",\n  \"password\": \"xxxx\",\n  \"partnerId\": \"xxxx\",\n  \"multiSearchByGeo\": {\n    \"geoLat\": \"19.484011\",\n    \"geoLong\": \"99.053970\"\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": "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": "multiSearchByGeo",
        "kind": "required",
        "type": "object",
        "description": "",
        "": "multiSearchByGeo",
        "children": [
          {
            "name": "geoLat",
            "kind": "required",
            "type": "string",
            "description": "Latitude associated within the search"
          },
          {
            "name": "geoLong",
            "kind": "required",
            "type": "string",
            "description": "Longitude associated within the search"
          }
        ],
        "schema": [
          {
            "name": "geoLat",
            "kind": "required",
            "type": "string",
            "description": "Latitude associated within the search"
          },
          {
            "name": "geoLong",
            "kind": "required",
            "type": "string",
            "description": "Longitude 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": "ratesByNight",
        "kind": "required",
        "type": "object",
        "description": "",
        "": "required",
        "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."
              },
              {
                "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."
              },
              {
                "name": "numberOfAdults",
                "kind": "required",
                "type": "number",
                "description": "Must a number between 1 to 20."
              }
            ]
          }
        ]
      }
    ],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": true,
  "response": [
    {
      "name": "success",
      "kind": "optional",
      "type": "boolean",
      "description": "ID of the cake retrieved"
    },
    {
      "name": "tokenId",
      "kind": "optional",
      "type": "string",
      "description": "",
      "children": []
    },
    {
      "name": "errors",
      "kind": "optional",
      "type": "array",
      "description": "",
      "children": []
    }
  ],
  "autoGeneratedAnchorSlug": "search-by-geo",
  "legacyHash": "7fNdleIPgKHGZtCdadS2q"
}
```
:::