@snokam/mcp-api 0.5.1

package/specs/test/calculators.json

@@ -0,0 +1,1523 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "Calculators Function",
+    "description": "Calculators for Snøkam, e.g to calculate salary",
+    "version": "v1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://calculators.api.test.snokam.no"
+    }
+  ],
+  "paths": {
+    "/v1.0/salary": {
+      "get": {
+        "tags": [
+          "Salary"
+        ],
+        "summary": "Calculates salary",
+        "description": "Calculates salary based on time transaction summaries.",
+        "operationId": "CalculateSalary",
+        "parameters": [
+          {
+            "name": "Daily",
+            "in": "query",
+            "description": "Whether the salary is daily",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Whether the salary is daily"
+          }
+        ],
+        "requestBody": {
+          "description": "List of time transaction summaries",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/timeTransactionSummary"
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Salary calculated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/salarySummary"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/salaries": {
+      "get": {
+        "tags": [
+          "Salaries"
+        ],
+        "summary": "Calculates multiple salaries",
+        "description": "Calculates salaries for multiple employees based on time transaction summaries.",
+        "operationId": "CalculateSalaries",
+        "parameters": [
+          {
+            "name": "Daily",
+            "in": "query",
+            "description": "Whether the salary is daily",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Whether the salary is daily"
+          }
+        ],
+        "requestBody": {
+          "description": "List of time transaction employee summaries",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/employeeTimeTransactionSummary"
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Salaries calculated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/employeeSalary"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/salary/provision": {
+      "get": {
+        "tags": [
+          "Provision Salary"
+        ],
+        "summary": "Calculates provision salary",
+        "description": "Calculates provision salary based on provided parameters.",
+        "operationId": "CalculateProvisionSalary",
+        "parameters": [
+          {
+            "name": "Monthly",
+            "in": "query",
+            "description": "Whether the salary is monthly",
+            "required": true,
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Whether the salary is monthly"
+          },
+          {
+            "name": "BillableHours",
+            "in": "query",
+            "description": "Number of billable hours",
+            "required": true,
+            "schema": {
+              "type": "number",
+              "format": "float"
+            },
+            "x-ms-summary": "Number of billable hours"
+          },
+          {
+            "name": "HourlyRate",
+            "in": "query",
+            "description": "Hourly rate",
+            "required": true,
+            "schema": {
+              "type": "number",
+              "format": "float"
+            },
+            "x-ms-summary": "Hourly rate"
+          },
+          {
+            "name": "Commission",
+            "in": "query",
+            "description": "Commission rate",
+            "required": true,
+            "schema": {
+              "type": "number",
+              "format": "float"
+            },
+            "x-ms-summary": "Commission rate"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Provision salary calculated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/salaryLine"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Invalid input parameters",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/validationFailure"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          }
+        }
+      }
+    },
+    "/v1.0/salaries/estimate": {
+      "post": {
+        "tags": [
+          "Salaries"
+        ],
+        "summary": "Estimates multiple salaries",
+        "description": "Estimates salaries for multiple employees based on provided data.",
+        "operationId": "EstimateSalaries",
+        "requestBody": {
+          "description": "List of salary estimates",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/salaryEstimateInput"
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Salaries estimated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salaryEstimateWithEmployee"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/salary/estimate": {
+      "get": {
+        "tags": [
+          "Salary"
+        ],
+        "summary": "Estimates salary",
+        "description": "Estimates salary based on provided parameters.",
+        "operationId": "EstimateSalary",
+        "parameters": [
+          {
+            "name": "Monthly",
+            "in": "query",
+            "description": "Whether the salary is monthly",
+            "schema": {
+              "type": "boolean"
+            },
+            "x-ms-summary": "Whether the salary is monthly"
+          },
+          {
+            "name": "BillableHours",
+            "in": "query",
+            "description": "Number of billable hours",
+            "required": true,
+            "schema": {
+              "type": "number",
+              "format": "float"
+            },
+            "x-ms-summary": "Number of billable hours"
+          },
+          {
+            "name": "HourlyRate",
+            "in": "query",
+            "description": "Hourly rate",
+            "required": true,
+            "schema": {
+              "type": "number",
+              "format": "float"
+            },
+            "x-ms-summary": "Hourly rate"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Salary estimated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/salaryEstimate"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Invalid input parameters",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/validationFailure"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          }
+        }
+      }
+    },
+    "/v1.0/stock/shareholders": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get all shareholders",
+        "description": "Returns a list of all shareholders including their details and employee links.",
+        "operationId": "GetShareholders",
+        "responses": {
+          "200": {
+            "description": "List of shareholders retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/shareholder"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/stock/transactions": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get all stock transactions",
+        "description": "Returns a list of all stock transactions ordered by date.",
+        "operationId": "GetTransactions",
+        "responses": {
+          "200": {
+            "description": "List of transactions retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/stockTransaction"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/stock/ownership": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get current ownership distribution",
+        "description": "Returns the current ownership distribution calculated from all transactions.",
+        "operationId": "GetCurrentOwnership",
+        "responses": {
+          "200": {
+            "description": "Current ownership distribution retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/shareholderOwnership"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/stock/ownership/history": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get ownership history over time",
+        "description": "Returns snapshots of ownership distribution at each transaction date.",
+        "operationId": "GetOwnershipHistory",
+        "responses": {
+          "200": {
+            "description": "Ownership history retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ownershipSnapshot"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/stock/overview": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get complete stock overview",
+        "description": "Returns a complete overview including current ownership, recent transactions, and history.",
+        "operationId": "GetStockOverview",
+        "responses": {
+          "200": {
+            "description": "Stock overview retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/stockOverview"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/stock/me": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get my stock information",
+        "description": "Returns the current user's stock information including ownership, transactions, and value.",
+        "operationId": "GetMyStockInfo",
+        "responses": {
+          "200": {
+            "description": "Employee stock info retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/employeeStockInfo"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "Unauthorized access",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No shareholding found for the current user",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://1e28e887-f8e4-452b-b091-3ab5bafdd6ba/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/stock/me/ownership": {
+      "get": {
+        "tags": [
+          "Stock"
+        ],
+        "summary": "Get my ownership percentage",
+        "description": "Returns the current user's ownership percentage for use in valuation calculations.",
+        "operationId": "GetMyOwnership",
+        "responses": {
+          "200": {
+            "description": "Employee ownership retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/shareholderOwnership"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "Unauthorized access",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No shareholding found for the current user",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://1e28e887-f8e4-452b-b091-3ab5bafdd6ba/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/valuation/calculate": {
+      "get": {
+        "tags": [
+          "Valuation"
+        ],
+        "summary": "Calculates ownership valuation",
+        "description": "Calculates ownership valuation based on provided percentage.",
+        "operationId": "CalculateOwnershipValuation",
+        "parameters": [
+          {
+            "name": "Percent",
+            "in": "query",
+            "description": "Percentage of ownership",
+            "required": true,
+            "schema": {
+              "type": "number",
+              "format": "float"
+            },
+            "x-ms-summary": "Percentage of ownership"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Ownership valuation calculated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/valuation"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Invalid input parameters",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/validationFailure"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          }
+        }
+      }
+    },
+    "/v1.0/valuation": {
+      "get": {
+        "tags": [
+          "Valuation"
+        ],
+        "summary": "Gets ownership valuation",
+        "description": "Gets ownership valuation.",
+        "operationId": "OwnershipValuation",
+        "responses": {
+          "200": {
+            "description": "Ownership valuation retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/valuation"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "Unauthorized access",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://1e28e887-f8e4-452b-b091-3ab5bafdd6ba/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/valuation/me": {
+      "get": {
+        "tags": [
+          "Valuation"
+        ],
+        "summary": "Gets my ownership valuation",
+        "description": "Gets ownership valuation of the current user.",
+        "operationId": "MyOwnershipValuation",
+        "responses": {
+          "200": {
+            "description": "Ownership valuation retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/valuation"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "Unauthorized access",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://1e28e887-f8e4-452b-b091-3ab5bafdd6ba/user_impersonation"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/wagerates": {
+      "get": {
+        "tags": [
+          "Wage Rates"
+        ],
+        "summary": "Gets wage rates",
+        "description": "Retrieves wage rates for a specified date.",
+        "operationId": "WageRates",
+        "parameters": [
+          {
+            "name": "date",
+            "in": "query",
+            "description": "The date for which to retrieve wage rates",
+            "schema": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "x-ms-summary": "The date for which to retrieve wage rates"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Wage rates retrieved successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/wageRate"
+                  }
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "employeeSalary": {
+        "required": [
+          "name",
+          "email",
+          "salaryLines",
+          "salary"
+        ],
+        "type": "object",
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "email": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "salaryLines": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/iSalary"
+            }
+          },
+          "salary": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
+      "employeeStockInfo": {
+        "required": [
+          "employeeId",
+          "employeeName",
+          "employeeEmail",
+          "shareholderId",
+          "shareholderName",
+          "shares",
+          "ownershipPercentage",
+          "value",
+          "transactionHistory",
+          "ownershipHistory"
+        ],
+        "type": "object",
+        "properties": {
+          "employeeId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "employeeName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "employeeEmail": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "employeeImageUrl": {
+            "type": "string"
+          },
+          "shareholderId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "shareholderName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "shares": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "ownershipPercentage": {
+            "type": "number",
+            "format": "double"
+          },
+          "value": {
+            "type": "number",
+            "format": "double"
+          },
+          "valueAtStart": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "valueChange": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "valueChangePercentage": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "transactionHistory": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/stockTransaction"
+            }
+          },
+          "ownershipHistory": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ownershipSnapshot"
+            }
+          }
+        }
+      },
+      "employeeTimeTransactionSummary": {
+        "required": [
+          "name",
+          "email",
+          "timeTransactions"
+        ],
+        "type": "object",
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "email": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "timeTransactions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/timeTransactionSummary"
+            }
+          }
+        }
+      },
+      "employerTax": {
+        "type": "object",
+        "properties": {
+          "underLimit": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "aboveLimit": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "pension": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "holidayPay": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "total": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
+      "iSalary": {
+        "type": "object",
+        "properties": {
+          "salary": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
+      "ownershipSnapshot": {
+        "required": [
+          "date",
+          "totalShares",
+          "shareholders"
+        ],
+        "type": "object",
+        "properties": {
+          "date": {
+            "minLength": 1,
+            "type": "string",
+            "format": "date-time"
+          },
+          "totalShares": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "shareholders": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/shareholderOwnership"
+            }
+          },
+          "companyValuation": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          }
+        }
+      },
+      "pension": {
+        "type": "object",
+        "properties": {
+          "under12G": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "above7G": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "total": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
+      "salaryEstimate": {
+        "required": [
+          "title",
+          "hours",
+          "commission",
+          "hourlyRate",
+          "salary",
+          "pension",
+          "employerTax"
+        ],
+        "type": "object",
+        "properties": {
+          "title": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "hours": {
+            "type": "number",
+            "format": "float"
+          },
+          "commission": {
+            "type": "number",
+            "format": "float"
+          },
+          "hourlyRate": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "salary": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "holidayPay": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "pension": {
+            "$ref": "#/components/schemas/pension"
+          },
+          "employerTax": {
+            "$ref": "#/components/schemas/employerTax"
+          }
+        }
+      },
+      "salaryEstimateInput": {
+        "required": [
+          "name",
+          "email",
+          "title",
+          "hours",
+          "commission",
+          "hourlyRate"
+        ],
+        "type": "object",
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "email": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "title": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "hours": {
+            "type": "number",
+            "format": "float"
+          },
+          "commission": {
+            "type": "number",
+            "format": "float"
+          },
+          "hourlyRate": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      },
+      "salaryEstimateWithEmployee": {
+        "required": [
+          "name",
+          "email",
+          "title",
+          "hours",
+          "commission",
+          "hourlyRate",
+          "salary",
+          "pension",
+          "employerTax"
+        ],
+        "type": "object",
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "email": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "title": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "hours": {
+            "type": "number",
+            "format": "float"
+          },
+          "commission": {
+            "type": "number",
+            "format": "float"
+          },
+          "hourlyRate": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "salary": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "holidayPay": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "pension": {
+            "$ref": "#/components/schemas/pension"
+          },
+          "employerTax": {
+            "$ref": "#/components/schemas/employerTax"
+          }
+        }
+      },
+      "salaryLine": {
+        "required": [
+          "salary",
+          "pension",
+          "employerTax"
+        ],
+        "type": "object",
+        "properties": {
+          "salary": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "holidayPay": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "pension": {
+            "$ref": "#/components/schemas/pension"
+          },
+          "employerTax": {
+            "$ref": "#/components/schemas/employerTax"
+          }
+        }
+      },
+      "salarySummary": {
+        "required": [
+          "salary",
+          "salaryLines"
+        ],
+        "type": "object",
+        "properties": {
+          "salary": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "salaryLines": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/iSalary"
+            }
+          }
+        }
+      },
+      "shareholder": {
+        "required": [
+          "id",
+          "name",
+          "type"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "organizationNumber": {
+            "type": "string"
+          },
+          "personalNumber": {
+            "type": "string"
+          },
+          "employeeId": {
+            "type": "string"
+          },
+          "employeeName": {
+            "type": "string"
+          },
+          "employeeEmail": {
+            "type": "string"
+          },
+          "employeeImageUrl": {
+            "type": "string"
+          }
+        }
+      },
+      "shareholderOwnership": {
+        "required": [
+          "shareholderId",
+          "shareholderName",
+          "shareholderType",
+          "shares",
+          "ownershipPercentage"
+        ],
+        "type": "object",
+        "properties": {
+          "shareholderId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "shareholderName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "shareholderType": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "employeeId": {
+            "type": "string"
+          },
+          "employeeName": {
+            "type": "string"
+          },
+          "employeeEmail": {
+            "type": "string"
+          },
+          "employeeImageUrl": {
+            "type": "string"
+          },
+          "holderOwnerId": {
+            "type": "string"
+          },
+          "holderOwnerName": {
+            "type": "string"
+          },
+          "shares": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "ownershipPercentage": {
+            "type": "number",
+            "format": "double"
+          },
+          "value": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "asOfDate": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      },
+      "stockOverview": {
+        "required": [
+          "totalShares",
+          "currentOwnership",
+          "recentTransactions",
+          "ownershipHistory"
+        ],
+        "type": "object",
+        "properties": {
+          "totalShares": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "currentOwnership": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/shareholderOwnership"
+            }
+          },
+          "recentTransactions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/stockTransaction"
+            }
+          },
+          "ownershipHistory": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ownershipSnapshot"
+            }
+          },
+          "valuationHistory": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/valuationHistoryItem"
+            }
+          },
+          "companyValuation": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          }
+        }
+      },
+      "stockTransaction": {
+        "required": [
+          "id",
+          "transactionNumber",
+          "date",
+          "transactionType",
+          "toShareholderId",
+          "toShareholderName",
+          "shares"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "transactionNumber": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "date": {
+            "minLength": 1,
+            "type": "string",
+            "format": "date-time"
+          },
+          "transactionType": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "splitRatio": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "fromShareholderId": {
+            "type": "string"
+          },
+          "fromShareholderName": {
+            "type": "string"
+          },
+          "toShareholderId": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "toShareholderName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "shares": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "pricePerShare": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "totalValue": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "notes": {
+            "type": "string"
+          }
+        }
+      },
+      "timeTransactionSummary": {
+        "required": [
+          "activityCode",
+          "activityName"
+        ],
+        "type": "object",
+        "properties": {
+          "activityCode": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "activityName": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "projectCode": {
+            "type": "string",
+            "nullable": true
+          },
+          "projectName": {
+            "type": "string",
+            "nullable": true
+          },
+          "hours": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "commission": {
+            "type": "number",
+            "format": "double",
+            "nullable": true
+          },
+          "hourlyRate": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          }
+        }
+      },
+      "validationFailure": {
+        "type": "object",
+        "properties": {
+          "propertyName": {
+            "type": "string"
+          },
+          "errorMessage": {
+            "type": "string"
+          },
+          "attemptedValue": {
+            "type": "object"
+          },
+          "customState": {
+            "type": "object"
+          },
+          "severity": {
+            "enum": [
+              0,
+              1,
+              2
+            ],
+            "type": "integer",
+            "format": "int32",
+            "default": 0
+          },
+          "errorCode": {
+            "type": "string"
+          },
+          "formattedMessagePlaceholderValues": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object"
+            }
+          }
+        }
+      },
+      "valuation": {
+        "required": [
+          "name",
+          "email",
+          "image",
+          "company",
+          "employee",
+          "nextEmployee",
+          "date",
+          "numberOfEmployees",
+          "employeesStartingThisMonth",
+          "employeeHasStarted",
+          "employeeStartedThisMonth",
+          "history"
+        ],
+        "type": "object",
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "email": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "image": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "company": {
+            "type": "number",
+            "format": "float"
+          },
+          "employee": {
+            "type": "number",
+            "format": "float"
+          },
+          "nextEmployee": {
+            "type": "number",
+            "format": "float"
+          },
+          "date": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "numberOfEmployees": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "employeesStartingThisMonth": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/valuationEmployee"
+            }
+          },
+          "employeeHasStarted": {
+            "type": "boolean"
+          },
+          "employeeStartedThisMonth": {
+            "type": "boolean"
+          },
+          "history": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/valuation"
+            }
+          }
+        }
+      },
+      "valuationEmployee": {
+        "required": [
+          "name",
+          "email",
+          "image"
+        ],
+        "type": "object",
+        "properties": {
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "email": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "image": {
+            "minLength": 1,
+            "type": "string"
+          }
+        }
+      },
+      "valuationHistoryItem": {
+        "required": [
+          "date",
+          "companyValuation"
+        ],
+        "type": "object",
+        "properties": {
+          "date": {
+            "minLength": 1,
+            "type": "string",
+            "format": "date-time"
+          },
+          "companyValuation": {
+            "type": "number",
+            "format": "double"
+          },
+          "numberOfEmployees": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "employeesStartingThisMonth": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/valuationEmployee"
+            }
+          }
+        }
+      },
+      "wageRate": {
+        "required": [
+          "sickLeave",
+          "militaryService",
+          "baseSalary",
+          "basicAmount",
+          "hoursThisYear"
+        ],
+        "type": "object",
+        "properties": {
+          "sickLeave": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "militaryService": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "baseSalary": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "basicAmount": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "hoursThisYear": {
+            "type": "integer",
+            "format": "int32"
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "Implicit": {
+        "type": "oauth2",
+        "flows": {
+          "implicit": {
+            "authorizationUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/authorize",
+            "tokenUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/token",
+            "refreshUrl": "https://login.microsoftonline.com/a8533784-aa3c-403b-a61a-1533ecc6e3ed/oauth2/v2.0/token",
+            "scopes": {
+              "api://1e28e887-f8e4-452b-b091-3ab5bafdd6ba/user_impersonation": "Default function scope"
+            }
+          }
+        }
+      }
+    }
+  }
+}