{
  "openapi": "3.1.0",
  "info": {
    "title": "Mizan Shariah equity screening",
    "version": "1.0.0",
    "description": "Screens a US-listed company against four published Shariah equity standards (AAOIFI, Dow Jones Islamic Market, S&P Shariah, MSCI Islamic) using live market data and the company's own SEC filings. Research output, not investment advice.",
    "contact": {
      "name": "Mizan",
      "email": "hello@askmizan.com",
      "url": "https://askmizan.com"
    },
    "license": {
      "name": "Free to use, attribution appreciated"
    }
  },
  "servers": [
    {
      "url": "https://askmizan.com/api/v1"
    }
  ],
  "paths": {
    "/screen/{ticker}": {
      "get": {
        "operationId": "screenCompany",
        "summary": "Screen one company against all four standards",
        "description": "Returns the live price, the consolidated share count, the filing figures used, and each standard's ratio, threshold and verdict. Verdicts within one percent of a threshold are flagged borderline.",
        "parameters": [
          {
            "name": "ticker",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z.\\-]{0,9}$"
            },
            "example": "AAPL",
            "description": "US listing symbol."
          }
        ],
        "responses": {
          "200": {
            "description": "Screening result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Malformed ticker"
          },
          "404": {
            "description": "Company is outside the 424-company panel"
          },
          "503": {
            "description": "Live price or share count unavailable, so no verdict is given"
          }
        }
      }
    },
    "/standards": {
      "get": {
        "operationId": "listStandards",
        "summary": "The four standards, their denominators and thresholds",
        "responses": {
          "200": {
            "description": "Standards"
          }
        }
      }
    },
    "/health": {
      "get": {
        "operationId": "health",
        "summary": "Service status and panel provenance",
        "responses": {
          "200": {
            "description": "Status"
          }
        }
      }
    }
  }
}