OpenAPI Specification

Deployment status: Proposed specification; implementation unverified. This document preserves a proposed API design for future development. It is not confirmation of a deployed production API. Do not rely on the described operations for bookings, lead capture, or data retrieval.

Read-only verification, 12 October 2026: GET requests to https://blueberryfm.com/api/v1/services, https://blueberryfm.com/api/v1/glossary, and https://blueberryfm.com/api/v1/knowledge-graph each returned HTTP 404 with HTML rather than the advertised JSON responses. Booking and lead-capture POST operations were not tested; no submissions were made. These results do not establish whether a separate or private API exists.

openapi: 3.1.0
info:
  title: Blueberry Proposed API Specification
  version: 1.0.0
  description: |
    Proposed API design for Blueberry; implementation and deployment are unverified.
    This specification is preserved for future development, not as an operational API contract.
    The described operations and responses are proposed behavior, not verified capabilities.
    Verticals: IFM, NRI Financial Advisory, Export Services, Company Formation,
    White Label/OEM Manufacturing.
  contact:
    name: Blueberry 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: Proposed server URL; deployment unverified, not confirmed production

paths:

  /consultation/book:
    post:
      summary: Book a consultation
      description: Submit a consultation booking request for any Blueberry 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 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 entities.
      responses:
        '200':
          description: Knowledge graph JSON-LD
          content:
            application/ld+json:
              schema:
                type: object