openapi: 3.0.3
info:
  title: 5280 Legends API
  description: |
    5280 Legends is a curated directory of verified, owner-operated local businesses in Denver, Colorado.

    This API provides access to business listings across Denver's best neighborhoods including:
    - Cherry Creek
    - Colfax
    - Central Park
    - Park Hill
    - Congress Park
    - Hilltop
    - Lowry

    All businesses are owner-operated and personally verified. No paid placements.
  version: "1.0.0"
  contact:
    name: 5280 Legends Support
    email: hello@5280locallegends.com
    url: https://5280locallegends.com
  termsOfService: https://5280locallegends.com/terms-conditions

servers:
  - url: https://5280locallegends.com
    description: Production

tags:
  - name: Businesses
    description: Local business listings
  - name: Neighborhoods
    description: Denver neighborhood information
  - name: Categories
    description: Business categories

paths:
  /search:
    get:
      summary: Search businesses
      description: Search for local businesses by name, category, or neighborhood
      operationId: searchBusinesses
      tags:
        - Businesses
      parameters:
        - name: q
          in: query
          description: Search query (business name, category, or keyword)
          required: false
          schema:
            type: string
            example: "restaurant"
      responses:
        '200':
          description: Search results page with matching businesses
          content:
            text/html:
              schema:
                type: string

  /business/{slug}:
    get:
      summary: Get business details
      description: Get detailed information about a specific business
      operationId: getBusinessBySlug
      tags:
        - Businesses
      parameters:
        - name: slug
          in: path
          description: Business slug identifier
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Business detail page
          content:
            text/html:
              schema:
                type: string

  /neighborhood/{neighborhoodId}:
    get:
      summary: Get neighborhood businesses
      description: List all businesses in a specific Denver neighborhood
      operationId: getNeighborhoodBusinesses
      tags:
        - Neighborhoods
      parameters:
        - name: neighborhoodId
          in: path
          required: true
          schema:
            type: string
            enum:
              - cherry-creek
              - colfax
              - central-park
              - park-hill
              - congress-park
              - hilltop
              - lowry
      responses:
        '200':
          description: Neighborhood page with business listings
          content:
            text/html:
              schema:
                type: string

  /category/{categoryId}:
    get:
      summary: Get category businesses
      description: List all businesses in a specific category
      operationId: getCategoryBusinesses
      tags:
        - Categories
      parameters:
        - name: categoryId
          in: path
          required: true
          schema:
            type: string
            enum:
              - food-fun
              - health-fitness
              - professionals
              - shop
              - trades
      responses:
        '200':
          description: Category page with business listings
          content:
            text/html:
              schema:
                type: string

externalDocs:
  description: LLM Context Files
  url: https://5280locallegends.com/llms.txt