{
 "openapi": "3.1.0",
 "info": {
  "title": "SickSlip note verification API",
  "version": "1.0.0",
  "description": "Public, read-only verification of a SickSlip physician-signed doctor's note by its Document ID (the 8-character code printed on the note, or the full verification code). Returns whether the document is genuine, its issued date, the certified absence dates and the signing physician's public credentials. It never returns a diagnosis or any medical detail. Rate-limited. No authentication.",
  "contact": {
   "name": "SickSlip",
   "url": "https://www.sickslip.co/verify",
   "email": "support@sickslip.co"
  }
 },
 "servers": [
  {
   "url": "https://sickslip.onrender.com"
  }
 ],
 "paths": {
  "/api/verify/{code}": {
   "get": {
    "operationId": "verifySickSlipNote",
    "summary": "Verify a SickSlip doctor's note by Document ID",
    "parameters": [
     {
      "name": "code",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "minLength": 8
      },
      "description": "The Document ID printed on the note (8 characters, e.g. 03B4CE26) or the full verification code."
     }
    ],
    "responses": {
     "200": {
      "description": "Verification result",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "valid": {
           "type": "boolean"
          },
          "status": {
           "type": "string",
           "description": "Present when valid is false, e.g. REVOKED or NOT_FOUND"
          },
          "documentId": {
           "type": "string"
          },
          "issuedDate": {
           "type": "string"
          },
          "absenceDates": {
           "type": "object"
          },
          "physician": {
           "type": "object",
           "properties": {
            "name": {
             "type": "string"
            },
            "npi": {
             "type": "string"
            }
           }
          },
          "stateLicensed": {
           "type": "string"
          },
          "modified": {
           "type": "boolean"
          },
          "modifiedAt": {
           "type": "string"
          },
          "revokedAt": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "429": {
      "description": "Rate limited"
     }
    }
   }
  }
 },
 "x-mcp-server": "https://sickslip.onrender.com/api/mcp",
 "x-npm-package": "sickslip-mcp"
}