{
  "openapi": "3.0.3",
  "info": {
    "title": "ProximaHub API",
    "version": "1.0.0",
    "description": "API for ProximaHub biometric device synchronization, punch logs, and license provisioning."
  },
  "x-service-info": {
    "categories": [
      "attendance",
      "biometrics",
      "payroll",
      "saas"
    ]
  },
  "servers": [
    {
      "url": "https://hub.proximalink.pk"
    }
  ],
  "paths": {
    "/api/v1/licenses/purchase": {
      "post": {
        "summary": "Purchase a ProximaHub subscription license",
        "operationId": "purchaseLicense",
        "description": "Acquire or renew an active ProximaHub attendance license seat (PKR 60, AED 3.00, or USD 1.00 per user / mo).",
        "x-payment-info": {
          "intent": "charge",
          "method": "stripe",
          "amount": "1.00",
          "currency": "USD",
          "description": "Global Starter subscription ($1.00 / user / month)"
        },
        "responses": {
          "200": {
            "description": "License generated successfully"
          }
        }
      }
    },
    "/api/v1/health": {
      "get": {
        "summary": "Health status",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Hub service healthy"
          }
        }
      }
    }
  }
}