OpenAPI Specification

openapi: 3.1.0
info:
  title: Blueberry FM Public API
  version: 1.0.0
  description: |
    Public API for Blueberry FM — a multi-vertical enterprise services platform
    operating across UAE, GCC, and India.
    Verticals: IFM, NRI Financial Advisory, Export Services, Company Formation,
    White Label/OEM Manufacturing.
  contact:
    name: Blueberry FM Support
    url: https://blueberryfm.com/pages/contact
  license:
    name: Proprietary
    url: https://blueberryfm.com/policies/terms-of-service

servers:
  - url: https://blueberryfm.com/api/v1
    description: Production server

paths:

  /consultation/book:
    post:
      summary: Book a consultation
      description: Submit a consultation booking request for any Blueberry FM service vertical.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [name, email, service_vertical]
              properties:
                name:
                  type: string
                  example: Rajesh Kumar
                email:
                  type: string
                  format: email
                  example: rajesh@example.com
                phone:
                  type: string
                  example: "+971501234567"
                service_vertical:
                  type: string
                  enum: [IFM, NRI_Finance, Export, Company_Formation, Manufacturing]
                message:
                  type: string
      responses:
        '200':
          description: Booking confirmed
        '400':
          description: Invalid request

  /leads/capture:
    post:
      summary: Capture a lead
      description: Submit a lead enquiry for any Blueberry FM service.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [name, email, interest]
              properties:
                name:
                  type: string
                email:
                  type: string
                  format: email
                interest:
                  type: string
                  enum: [IFM, NRI_Finance, Export, Company_Formation, Manufacturing, General]
                country:
                  type: string
                  example: UAE
      responses:
        '200':
          description: Lead captured
        '400':
          description: Invalid request

  /services:
    get:
      summary: List all services
      description: Returns the full machine-readable service catalog.
      responses:
        '200':
          description: Service catalog JSON
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                    vertical:
                      type: string
                    description:
                      type: string
                    url:
                      type: string
                    geographies:
                      type: array
                      items:
                        type: string

  /glossary:
    get:
      summary: Retrieve glossary terms
      description: Returns all glossary terms and definitions across all service verticals.
      parameters:
        - name: vertical
          in: query
          required: false
          schema:
            type: string
            enum: [IFM, NRI_Finance, Export, Company_Formation, Manufacturing]
      responses:
        '200':
          description: Glossary terms
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    term:
                      type: string
                    definition:
                      type: string
                    vertical:
                      type: string

  /knowledge-graph:
    get:
      summary: Retrieve knowledge graph
      description: Returns the full JSON-LD knowledge graph for Blueberry FM entities.
      responses:
        '200':
          description: Knowledge graph JSON-LD
          content:
            application/ld+json:
              schema:
                type: object