openapi: "3.1.0"
info:
  title: "Ajaib - Pilihan 1 Investor Indonesia — Bilarna Provider API"
  version: "1.0.0"
  description: |
    Machine-readable API for interacting with Ajaib - Pilihan 1 Investor Indonesia on the Bilarna B2B network.
    Mulai investasi online dengan Ajaib. Platform investasi terpercaya yang aman, sudah berizin dan diawasi OJK & BAPPEBTI. Download aplikasinya & daftar sekarang!
    Services offered: 24/7 IT Support, 360 Branding Agency, 360-Degree Digital Marketing Strategy, 3D Animation Services, AI and Automation Solutions, AI Anomaly Detection Services, AI Consulting, AI Content Marketing, AI Integration Services, AI Marketing Agents, AI Performance Marketing, AI Search Optimization, AI Video Production, AI-Powered UX Design, Automotive HMI Design, B2B Digital Marketing Services, B2B Marketing Consulting, Back-Office Outsourcing Services, BIM Modeling Services, Brand Development Consulting, Brand Digital Experience Services, Brand Identity Design, Brand Identity Development, Brand Positioning Strategy Services, Brand Strategy & Execution, Brand Strategy & Identity Design, Brand Strategy and Design, Brand Strategy Consulting, Brand Strategy Services, Branding & Creative Services, Branding and UX/UI Design, Branding Design, Business Intelligence Platforms, Business Process Automation, Business Web Hosting, Call Center Outsourcing, Call Center Services, Cloud ERP Implementation, Cloud GPU Rendering, Cloud HR Software, Cloud Infrastructure Consulting, Cloud Migration Consulting, Cloud Migration Services, Commercial Video Production, Content Marketing Services, Content Marketing Strategy, Conversational AI Platforms, Corporate Branding Services, Corporate Event Production, Corporate PR & Communications, Corporate Video Production, Creative Strategy Consulting, Crisis Communications Management, Crisis Management Services, CRM Implementation Consulting, CRM Implementation Service, CRM Implementation Services, CRM Software Providers, CRM Software Solutions, CRO Services, Custom AI Development, Custom AI Integration Services, Custom Booth Design and Build, Custom Ecommerce Platform Development, Custom Enterprise Software, Custom Enterprise Software Development, Custom Metal Fabrication, Custom MLM Software Development, Custom Signage Fabrication, Custom Software Development, Custom Web App Development, Custom Web App Development, Custom Web Design, Custom Web Development, Custom Website Design, Custom Website Design & Development, Custom Website Development, Custom WordPress Development, CX Consulting Services, Data-Driven Marketing Consulting, Digital Advertising Services, Digital Branding Studio, Digital Content and Community Revenue, Digital Infrastructure Consulting, Digital Marketing Analytics, Digital Marketing Campaigns, Digital Marketing Management, Digital Marketing Services, Digital Marketing Strategy, Digital Marketing Strategy & Implementation, Digital Media Advertising, Digital Product Design, Digital Product Development, Digital Strategy Consulting, Digital Transformation Strategy, Done-For-You Marketing, E-commerce Website Development, EHS Compliance Management, Electronic Invoice Management Software, Employer of Record, Employer of Record Services, Enterprise App Development, Enterprise Software Development, Enterprise Web Development, ERP Implementation Consulting, ERP Implementation Services, Event Management Services, Event PR & Media Strategy, Executive Leadership Coaching, Executive Recruitment, Executive Search, Explainer Video Production, Financial Audit, Financial Regulatory Services, Full Service Digital Marketing, Full-Service Digital Agency, Full-Service Video Production, Global Market Entry Services, Global SEO Marketing Services, Higher Education ERP, HR Consulting Services, Inbound Customer Support, Independent Software Verification, Industrial Design Services, Integrated Brand Experience, Integrated Communications Services, Integrated Digital Marketing, Integrated Marketing Services, Integrated Public Relations Services, International Customer Support, International Marketing Services, iOS App Development, IT Consulting Services, IT Infrastructure Outsourcing, IT Support Services, Japan Market Entry Consulting, Japanese Market Entry Services, Leadership Development Programs, Local Web Hosting, Managed Cybersecurity Services, Managed IT Services, Managed Print Services, Managed Security Services, Marketing Public Relations, MarTech Implementation Services, Media Relations Services, Multilingual Creative Agency, Offshore Product Engineering Squad, Online Advertising Services, Online Investment Platforms, Online Learning & Content Creation, Online Presence Audit, Operational Efficiency Solutions, Owned Media Strategy, Paid Search Advertising, Pay-Per-Click Advertising, Payroll & HR Software, Payroll Processing, Payroll Processing Services, Penetration Testing Services, Performance Marketing Agency, Performance Marketing Services, PIM Software Solutions, PMO Marketing Support, PR and Media Relations, PR Strategy Development, Predictive Analytics Solutions, Procurement and Supply Chain Software, Professional Event Companionship Services, Professional SEO Services, Professional SEO Services, Programmatic Ad Buying, Promotional Video Production, Recruitment and Selection, Retail POS Systems, RPA Implementation Services, RPO Solutions, SaaS Launch PR, SaaS Product Development, Salary & Payroll Services, Sales Automation Tools, Salesforce CRM Implementation, Salesforce Implementation Consulting, Search Engine Optimization, Secure Business Cloud Storage, SEO & AEO Services, SEO Marketing Services, SEO Optimization Services, SEO Services, SIP Trunk Solutions, Social Media Ad Management, Social Media Advertising, Social Media Management Services, Social Media Marketing, Sports Betting Software, Startup Tech Development, Strategic Communication Consulting, Strategic Communications Consulting, Strategic Marketing Consulting, Strategic Narrative Consulting, Strategic PR Services, Sustainable Food Supply Consulting, Talent Management Solutions, Tech PR Agency, Technology Consulting Services, Telecom Tower Leasing, UI UX Design Services, Unlimited Internet, UPS Power Systems, UX/UI Design Services, VFX & Visual Effects Services, Web & Desktop App Development, Website & Software Localization, Website Development Services, WordPress Web Development.
  contact:
    name: "Ajaib - Pilihan 1 Investor Indonesia"
    url: "https://bilarna.com/provider/co"
  x-provider:
    slug: "co"
    verified: true
    accepts_meetings: false
    logo: "https://storage.googleapis.com/storage-ajaib-prd-platform-wp-artifact/2020/03/cropped-new_ajaib_logo.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 Ajaib - Pilihan 1 Investor Indonesia (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: "24/7 IT Support"
      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
