Casa Intelligence Casa Daily — Precedent API

openapi: 3.2.0
info:
  title: Casa Intelligence Engine Casa Daily — Precedent API
  description: Proprietary data ingestion, analysis, and prediction engine for Queensland property development intelligence.
  version: 2.0.0
tags:
- name: Casa Daily — Precedent
paths:
  /api/v1/cd-precedent/seed-suburbs:
    post:
      tags:
      - Casa Daily — Precedent
      summary: Seed Suburbs
      description: 'Return suburbs+zones where dev_type approvals concentrate.


        Performance notes: the townhouse predicate uses ILIKE patterns on

        `ci_da_applications.description` (no trigram GIN yet) and scans

        ~270K rows. Cold-cache call lands ~10-15s; subdivision/duplex/etc.

        are 1-5s because dev_type_classified covers them directly.


        Cache-Control set to `s-maxage=3600, stale-while-revalidate=86400` so

        Vercel''s edge layer + Casa-Daily''s fetch-cache make repeat calls

        free. The data updates daily (after the nightly DA ingestion run),

        so a 1-hour cache is well within the data freshness budget.'
      operationId: seed_suburbs_api_v1_cd_precedent_seed_suburbs_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrecedentSeedRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrecedentSeedResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - APIKeyHeader: []
components:
  schemas:
    PrecedentSeedResponse:
      properties:
        dev_type:
          type: string
          title: Dev Type
        lookback_months:
          type: integer
          title: Lookback Months
        lgas:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Lgas
        total:
          type: integer
          title: Total
        suburbs:
          items:
            $ref: '#/components/schemas/PrecedentSuburb'
          type: array
          title: Suburbs
        elapsed_ms:
          type: integer
          title: Elapsed Ms
      type: object
      required:
      - dev_type
      - lookback_months
      - lgas
      - total
      - suburbs
      - elapsed_ms
      title: PrecedentSeedResponse
    PrecedentSuburb:
      properties:
        lga:
          type: string
          title: Lga
        suburb:
          type: string
          title: Suburb
        zone_code:
          anyOf:
          - type: string
          - type: 'null'
          title: Zone Code
        approved_n:
          type: integer
          title: Approved N
        refused_n:
          type: integer
          title: Refused N
        decided_n:
          type: integer
          title: Decided N
        approval_rate_pct:
          type: number
          title: Approval Rate Pct
        newest_decision_year:
          anyOf:
          - type: integer
          - type: 'null'
          title: Newest Decision Year
        median_decision_year:
          anyOf:
          - type: integer
          - type: 'null'
          title: Median Decision Year
      type: object
      required:
      - lga
      - suburb
      - zone_code
      - approved_n
      - refused_n
      - decided_n
      - approval_rate_pct
      - newest_decision_year
      - median_decision_year
      title: PrecedentSuburb
    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
    PrecedentSeedRequest:
      properties:
        dev_type:
          type: string
          enum:
          - subdivision
          - duplex
          - townhouse
          - multi_unit
          - secondary_dwelling
          - mcu
          - kdr
          - single_dwelling
          title: Dev Type
          description: Development type to seed from.
        lookback_months:
          type: integer
          maximum: 120.0
          minimum: 6.0
          title: Lookback Months
          description: How far back to count approvals.
          default: 36
        lgas:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Lgas
          description: Restrict to these LGAs. None = all SEQ. Pass a subset (e.g. ['Sunshine Coast']) to seed within the user's preferred patch.
        min_approvals:
          type: integer
          maximum: 50.0
          minimum: 1.0
          title: Min Approvals
          description: Drop suburbs/zones with fewer approved DAs.
          default: 3
        min_approval_rate_pct:
          type: number
          maximum: 100.0
          minimum: 0.0
          title: Min Approval Rate Pct
          description: Drop (suburb, zone) combos where less than this %% of decided DAs were approved.
          default: 50.0
        limit:
          type: integer
          maximum: 100.0
          minimum: 1.0
          title: Limit
          description: Max (suburb, zone) tuples to return.
          default: 20
      type: object
      required:
      - dev_type
      title: PrecedentSeedRequest
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key