Casa Intelligence Casa Daily — Spatial API

openapi: 3.2.0
info:
  title: Casa Intelligence Engine Casa Daily — Spatial API
  description: Proprietary data ingestion, analysis, and prediction engine for Queensland property development intelligence.
  version: 2.0.0
tags:
- name: Casa Daily — Spatial
paths:
  /api/v1/cd-spatial/nearby-parcels:
    get:
      tags:
      - Casa Daily — Spatial
      summary: Nearby Parcels
      description: 'Cadastral parcels intersecting a bbox of `distance` m around (lat, lng).


        Sourced live from the QLD DCDB ArcGIS service. Use this when the

        in-DB ST_DWithin RPC returns empty for a property whose neighbours

        weren''t ingested yet (regional/rural addresses primarily).


        Two input modes:

        1. Pass `lat` + `lng` directly (callers that already have them).

        2. Pass `property_id` (UUID) and the endpoint looks up the

        centroid from ci_properties.centroid via ST_Y/ST_X. Saves the

        caller one DB round-trip; this is what casa-daily uses.


        On upstream timeout or error returns HTTP 503 — callers should treat

        that as "click-to-amalgamate unavailable for this lookup" and render

        the rest of the map normally.'
      operationId: nearby_parcels_api_v1_cd_spatial_nearby_parcels_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: lat
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            maximum: 90
            minimum: -90
          - type: 'null'
          description: Centre latitude (WGS84). Required unless property_id is given.
          title: Lat
        description: Centre latitude (WGS84). Required unless property_id is given.
      - name: lng
        in: query
        required: false
        schema:
          anyOf:
          - type: number
            maximum: 180
            minimum: -180
          - type: 'null'
          description: Centre longitude (WGS84). Required unless property_id is given.
          title: Lng
        description: Centre longitude (WGS84). Required unless property_id is given.
      - name: property_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: ci_properties.id (UUID). When given, the endpoint looks up the property's centroid and uses it as (lat,lng), so callers don't need to do a separate centroid query first.
          title: Property Id
        description: ci_properties.id (UUID). When given, the endpoint looks up the property's centroid and uses it as (lat,lng), so callers don't need to do a separate centroid query first.
      - name: distance
        in: query
        required: false
        schema:
          type: number
          maximum: 500
          minimum: 10
          description: Radius in metres; clamped 10-500.
          default: 150.0
          title: Distance
        description: Radius in metres; clamped 10-500.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NearbyParcelsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
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
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    NearbyParcelsResponse:
      properties:
        type:
          type: string
          title: Type
          default: FeatureCollection
        features:
          items:
            $ref: '#/components/schemas/NearbyParcelFeature'
          type: array
          title: Features
      type: object
      required:
      - features
      title: NearbyParcelsResponse
      description: GeoJSON FeatureCollection, ready to feed straight into MapLibre.
    NearbyParcelFeature:
      properties:
        type:
          type: string
          title: Type
          default: Feature
        id:
          anyOf:
          - type: string
          - type: 'null'
          title: Id
        geometry:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Geometry
        properties:
          additionalProperties: true
          type: object
          title: Properties
      type: object
      title: NearbyParcelFeature
      description: 'GeoJSON Feature with cadastral properties.


        Geometry is a Polygon (or null if ArcGIS returned no rings — those

        rows are filtered out before this model is constructed, so callers

        can assume geometry is present).'
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key