openapi: "3.1.0"
info:
  title: "Orionstarorion star orionstar robot lucki robot orion star robotlucki luckibot mini minibot service robot food service robot restaurant robot restaurant service robot food delivery robot robot waiter robot server delivery robot smart robot hospitality rob — Bilarna Provider API"
  version: "1.0.0"
  description: |
    Machine-readable API for interacting with Orionstarorion star orionstar robot lucki robot orion star robotlucki luckibot mini minibot service robot food service robot restaurant robot restaurant service robot food delivery robot robot waiter robot server delivery robot smart robot hospitality rob on the Bilarna B2B network.
    Discover OrionStar's LuckiBot Pro delivery robot, an advanced AI delivery robot with visual SLAM navigation, smart tray detection, and a 14
    Services offered: Automated Delivery Solutions, Robotics & Automation Services.
  contact:
    name: "Orionstarorion star orionstar robot lucki robot orion star robotlucki luckibot mini minibot service robot food service robot restaurant robot restaurant service robot food delivery robot robot waiter robot server delivery robot smart robot hospitality rob"
    url: "https://bilarna.com/provider/orionstar"
  x-provider:
    slug: "orionstar"
    verified: true
    accepts_meetings: false
    logo: "https://www.orionstar.com/res/orics/down/ow001_20250122_51a98a191311a878ab238c9204cd4af5.png"


servers:
  - url: "https://api.bilarna.com/api"
    description: Bilarna API

paths:
  /agent/match:
    post:
      operationId: bilarna_match
      summary: Find matching providers by service need
      description: |
        Returns a ranked list of providers (business_id, score, description).
        Use the returned business_id with /agent/request to submit a
        service request to Orionstarorion star orionstar robot lucki robot orion star robotlucki luckibot mini minibot service robot food service robot restaurant robot restaurant service robot food delivery robot robot waiter robot server delivery robot smart robot hospitality rob (business_id from match results).
      parameters:
        - name: api-version
          in: query
          required: true
          schema:
            type: string
            default: "1.0"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [need]
              properties:
                need:
                  type: string
                  description: Free-text service description
                  example: "Automated Delivery Solutions"
      responses:
        "200":
          description: Matched providers
          content:
            application/json:
              schema:
                type: object
                properties:
                  matchRequestId:
                    type: integer
                  candidates:
                    type: array
                    items:
                      type: object
                      properties:
                        business_id:
                          type: integer
                        score:
                          type: number
                        description:
                          type: string

  /agent/request:
    post:
      operationId: bilarna_request
      summary: Submit a service request to a provider
      description: |
        Sends a service request. When business_id is provided the request
        goes directly to that provider; otherwise Bilarna matches the
        request to relevant providers automatically.
      parameters:
        - name: api-version
          in: query
          required: true
          schema:
            type: string
            default: "1.0"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [need, contact_name, email]
              properties:
                business_id:
                  type: integer
                  description: Target provider ID (from bilarna_match)
                  nullable: true
                need:
                  type: string
                  description: Free-text description of the service need
                contact_name:
                  type: string
                  description: Full name of the decision-maker
                email:
                  type: string
                  format: email
                  description: Business email for lead routing
                phone:
                  type: string
                  description: Business phone number (optional)
                category:
                  type: string
                  description: Service category
                country:
                  type: string
                  description: Provider country preference
                budget_max:
                  type: number
                  description: Maximum project budget in USD
      responses:
        "200":
          description: Request created
          content:
            application/json:
              schema:
                type: object
                properties:
                  matchRequestId:
                    type: integer
                  business_id:
                    type: integer
                  lead:
                    type: object
                    properties:
                      contactName:
                        type: string
                      email:
                        type: string
                      phone:
                        type: string