openapi: 3.1.0
info:
  title: Neural Partners API
  description: Machine-readable API for Neural Partners AI marketing services and expertise
  version: 1.0.0
  contact:
    name: Neural Partners API Support
    email: team@neuralpartners.ai
    url: https://neuralpartners.ai/api/
  license:
    name: Public Domain
    url: https://neuralpartners.ai/legal/

servers:
  - url: https://neuralpartners.ai/api
    description: Production API server

paths:
  /services.json:
    get:
      operationId: getServices
      summary: Get all services
      description: Retrieve comprehensive catalog of Neural Partners services
      tags:
        - Services
      responses:
        '200':
          description: Successful response with services data
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: "2.0"
                  result:
                    type: object
                    properties:
                      services:
                        type: array
                        items:
                          $ref: '#/components/schemas/Service'
  
  /expertise.json:
    get:
      operationId: getExpertise
      summary: Get expertise areas
      description: Retrieve detailed expertise areas and capabilities
      tags:
        - Expertise
      responses:
        '200':
          description: Successful response with expertise data
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    example: "2.0"
                  result:
                    type: object
                    properties:
                      expertise_areas:
                        type: array
                        items:
                          $ref: '#/components/schemas/Expertise'

components:
  schemas:
    Service:
      type: object
      properties:
        id:
          type: string
          description: Unique service identifier
        name:
          type: string
          description: Service name
        category:
          type: string
          description: Service category (Neural Core, Neural Intellect, etc.)
        description:
          type: string
          description: Detailed service description
        url:
          type: string
          format: uri
          description: Service page URL
        key_features:
          type: array
          items:
            type: string
          description: Key features of the service
        technologies:
          type: array
          items:
            type: string
          description: Technologies used
        pricing_model:
          type: string
          description: Pricing structure
        typical_duration:
          type: string
          description: Typical engagement duration
    
    Expertise:
      type: object
      properties:
        id:
          type: string
          description: Unique expertise identifier
        name:
          type: string
          description: Expertise area name
        category:
          type: string
          description: Expertise category
        proficiency_level:
          type: string
          enum: [Expert, Advanced, Intermediate]
          description: Proficiency level
        years_experience:
          type: integer
          description: Years of experience
        description:
          type: string
          description: Detailed expertise description
        key_capabilities:
          type: array
          items:
            type: string
          description: Key capabilities
        technologies:
          type: array
          items:
            type: string
          description: Technologies and tools
        success_metrics:
          type: array
          items:
            type: string
          description: Measurable success metrics

tags:
  - name: Services
    description: Neural Partners service offerings
  - name: Expertise
    description: Areas of expertise and capabilities

externalDocs:
  description: Neural Partners API Documentation
  url: https://neuralpartners.ai/api/