Busca por Cidade/Região

Cenário de busca quando o usuário seleciona uma região ou cidade, em vez de um hotel/condomínio específico. Este é um dos formatos de criteria.destinations aceitos pelo endpoint de busca de disponibilidade Long Stay — os headers e os demais parâmetros (comuns aos três cenários) estão documentados lá.

Parâmetros de criteria.destinations

Parâmetro	Tipo	Obrigatoriedade	Descrição	Exemplo
propertyId	string	Sim	ID da região/cidade selecionada (usado para cruzar com entitiesData.regions na resposta).	"3074"
mapBounds	object { s, w, n, e }	Não	Delimita a busca por uma área geográfica (bounding box) do mapa.	{ "s": -23.61, "w": -46.68, "n": -23.54, "e": -46.64 }
previousMapBounds	array de { s, w, n, e }	Não	Áreas do mapa já buscadas anteriormente (busca incremental ao navegar no mapa).	[]

Exemplo de Payload

{
  "engineRuleVersion": "1",
  "criteria": {
    "destinations": {
      "propertyId": "3074",
      "mapBounds": {
        "s": -23.620058786217363,
        "w": -46.71303842328313,
        "n": -23.56811992705665,
        "e": -46.66438157671684
      },
      "previousMapBounds": []
    },
    "time": {
      "endDate": "2026-10-01",
      "startDate": "2026-08-01"
    },
    "occupancy": {
      "adults": 1,
      "quantity": 1
    }
  },
  "purchaseSessionId": "K4xCpqmM7EMBUteR1Fqa2",
  "isLongStay": true
}