> ## Documentation Index
> Fetch the complete documentation index at: https://developers.portao3.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# /realms/{realmId}/organizations/{organizationId}/travel/hotel/searches/{searchId}/map



## OpenAPI

````yaml /api-reference/travel.openapi.json get /realms/{realmId}/organizations/{organizationId}/travel/hotel/searches/{searchId}/map
openapi: 3.0.3
info:
  title: Travel
  version: 1.0.0
  description: >-
    Portão 3 travel API. Generated by tools/openapi from code (routes +
    security) and the hand-written spec (request/response bodies). Search proxy
    (air/hotel/bus/vehicle) + passenger directory. Search POST bodies are
    validated per-vertical in the handler (tier=unknown); passenger bodies carry
    route-level zod schemas (typed). Responses proxied/presented without a
    schema layer. Confidence tiers: generated:typed=6 copied:manual=0
    unknown=17.
servers:
  - url: https://api.travel.v2.portao3.com.br/
    description: production
  - url: https://api.travel.dev.3pers.com.br/
    description: development
security:
  - bearerAuth: []
tags:
  - name: Travel Passengers
  - name: Travel Trips
  - name: Travel Search
paths:
  /realms/{realmId}/organizations/{organizationId}/travel/hotel/searches/{searchId}/map:
    get:
      tags:
        - Travel Search
      summary: >-
        /realms/{realmId}/organizations/{organizationId}/travel/hotel/searches/{searchId}/map
      operationId: >-
        getRealmsByRealmIdOrganizationsByOrganizationIdTravelHotelSearchesBySearchIdMap
      parameters:
        - name: realmId
          in: path
          required: true
          schema:
            type: string
        - name: organizationId
          in: path
          required: true
          schema:
            type: string
        - name: searchId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - COMPLETED
                      - PROCESSING
                      - FAILED
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        itemId:
                          type: string
                          description: >-
                            Bookable-item id — pass to the item-detail endpoint
                            for room options.
                        hotelId:
                          type: string
                        name:
                          type: string
                        cheapestFareAmount:
                          type: number
                          description: >-
                            Cheapest room rate for this property (provider
                            format; NOT converted).
                        cheapestFareCurrency:
                          type: string
                          description: >-
                            ISO 4217 alpha currency of `cheapestFareAmount`
                            (e.g. "BRL").
                        coordinates:
                          type: object
                          properties:
                            lat:
                              type: number
                            lng:
                              type: number
                          required:
                            - lat
                            - lng
                      required:
                        - itemId
                        - hotelId
                        - name
                        - cheapestFareAmount
                        - cheapestFareCurrency
                        - coordinates
                      description: >-
                        A single hotel map point: cheapest occurrence of a
                        property with coordinates.
                required:
                  - status
                description: >-
                  `results` is populated **only once `status` reaches
                  COMPLETED** — on a PROCESSING/FAILED poll it is absent, so it
                  is OPTIONAL (a typed client must null-check it while polling;
                  `?? []` at the render site). Hotels without known coordinates
                  are excluded, so a COMPLETED list may be smaller than the
                  search count.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````