Cubi Estate Listing API

openapi: 3.2.0
info:
  title: Cubi Estate Listing API
  version: 0.1.0
  description: 'Operations tagged Listing across 2 of this provider''s published API definitions: cubi-estate-openapi.json, cubi-estate-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://mcp.cubi.estate
  description: Host serving this spec (Swagger UI at https://mcp.cubi.estate/docs loads /openapi.json); also hosts the MCP endpoint https://mcp.cubi.estate/mcp
tags:
- name: Listing
paths:
  /listing/{listing_id}/map:
    get:
      summary: Embeddable map-only HTML fragment for a listing (chat pane iframe, §6)
      description: 'Map-only fragment (Leaflet POI map, no page chrome) for embedding in the

        web chat detail pane via an iframe. Same public/no-auth posture, id validation

        and language resolution as `listing_page`, but skips the LLM summary (the map

        doesn''t need it). Registered BEFORE `/listing/{id}` so the greedy `:path`

        converter doesn''t capture the trailing `/map`. Iframe-safe: the app sets no

        X-Frame-Options / frame-ancestors, so it embeds from cubi.estate (the FE

        proxies it same-origin).


        `?theme=dark` renders CARTO-dark tiles + a dark page palette to match the web

        chat''s dark detail pane; `?theme=light` (or omitted / anything else) = light.


        Accepts a source-prefixed id or a permalink guid, same as `/listing/{id}`

        (§36), so a guid URL works with `/map` appended too.'
      operationId: listing_map_fragment_listing__listing_id__map_get
      parameters:
      - name: listing_id
        in: path
        required: true
        schema:
          type: string
          title: Listing Id
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Listing
  /listing/{listing_id}:
    get:
      summary: Public HTML listing page (same layout as /report) for a catalogue listing id
      description: 'Public, SEO-friendly listing page rendered with the same template as

        /report. No auth — catalogue listings are already public. `listing_id` is

        the source-prefixed id (e.g. `remax:122911463-99`) OR a permalink guid

        (§36 — see `_listing_ref_to_id`). Language from `?lang=` then the

        Accept-Language header, default English.'
      operationId: listing_page_listing__listing_id__get
      parameters:
      - name: listing_id
        in: path
        required: true
        schema:
          type: string
          title: Listing Id
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Listing
    head:
      summary: Public HTML listing page (same layout as /report) for a catalogue listing id
      description: 'Public, SEO-friendly listing page rendered with the same template as

        /report. No auth — catalogue listings are already public. `listing_id` is

        the source-prefixed id (e.g. `remax:122911463-99`) OR a permalink guid

        (§36 — see `_listing_ref_to_id`). Language from `?lang=` then the

        Accept-Language header, default English.'
      operationId: headListingByListingId
      parameters:
      - name: listing_id
        in: path
        required: true
        schema:
          type: string
          title: Listing Id
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Listing
      x-operation-id-source: normalized
      x-operation-id-original: listing_page_listing__listing_id__get
    post:
      summary: Contact-form submission from the public listing page → contact_requests lead
      description: 'Backs the Contact-agent form on `/listing/{id}` (and `/listings/{guid}`,

        which posts here too — the JS submits to `window.location`).


        Posting to the PAGE''s own path, rather than a dedicated endpoint, is

        deliberate: www.cubi.estate proxies an explicit allow-list of paths to this

        backend and `/listing/:id` is on it, so this rides an existing rewrite (see

        `_listing_contact_section_html`). Rewrites are method-agnostic.


        Auth is the SAME gate the page itself uses (§26 content lock): only a

        signed-in visitor ever sees this form, so only a signed-in visitor may post

        it. Body is form-encoded (so the no-JS native submit works); the response is

        JSON when the client asks for it, else the re-rendered page with a banner.'
      operationId: listing_page_contact_listing__listing_id__post
      parameters:
      - name: listing_id
        in: path
        required: true
        schema:
          type: string
          title: Listing Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Listing
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
x-refined-from:
- cubi-estate-openapi.json
- cubi-estate-openapi.yml