{
  "components": {
    "schemas": {
      "Error": {
        "properties": {
          "error": {
            "properties": {
              "code": {
                "enum": [
                  "invalid_request",
                  "invalid_key",
                  "insufficient_scope",
                  "customer_suspended",
                  "not_found",
                  "source_unavailable",
                  "rate_limited",
                  "allowance_exhausted",
                  "register_error",
                  "internal",
                  "unavailable"
                ],
                "type": "string"
              },
              "details": {
                "type": "object"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            },
            "required": [
              "code",
              "message",
              "request_id",
              "details"
            ],
            "type": "object"
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "description": "A key issued to the customer company, bzk_...",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Norwegian company intelligence from public registers. Authenticate with `Authorization: Bearer bzk_...`; keys are never read from the URL. Every response carries X-Request-Id and Cache-Control: no-store. Every answer names its sources and whether it is complete; an unknown value is null, never zero. A monthly allowance per customer is shared by its keys and never exceeded (no overage). v1 is additive only.",
    "title": "biztrac API",
    "version": "v1"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/companies": {
      "get": {
        "description": "Finds Norwegian companies by name or organisation number. Companies only: no person is ever returned by this search.",
        "operationId": "company_search",
        "parameters": [
          {
            "description": "Matches to return, default 8.",
            "in": "query",
            "name": "limit",
            "schema": {
              "description": "Matches to return, default 8.",
              "maximum": 12,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Company name or nine-digit organisation number.",
            "in": "query",
            "name": "q",
            "required": true,
            "schema": {
              "description": "Company name or nine-digit organisation number.",
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "matches": {
                      "items": {
                        "properties": {
                          "industry": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "municipality": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "org_form": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "orgnr": {
                            "type": "string"
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "orgnr",
                          "name"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "query": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "query",
                    "matches"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Search companies",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "search_companies",
          "op": "company.search",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/compare": {
      "get": {
        "description": "The latest filed figures of two to six companies side by side. A company that is unknown or whose figures are withheld stays in the list with its own status.",
        "operationId": "company_compare",
        "parameters": [
          {
            "description": "Two to six nine-digit organisation numbers; in the URL repeat the parameter: orgnrs=a\u0026orgnrs=b.",
            "explode": true,
            "in": "query",
            "name": "orgnrs",
            "required": true,
            "schema": {
              "description": "Two to six nine-digit organisation numbers; in the URL repeat the parameter: orgnrs=a\u0026orgnrs=b.",
              "items": {
                "type": "string"
              },
              "maxItems": 6,
              "minItems": 2,
              "type": "array"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "companies": {
                      "items": {
                        "properties": {
                          "annual_result": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "assets": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "currency": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "employees": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "equity": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "equity_ratio_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "industry": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "kind": {
                            "enum": [
                              "observed",
                              "estimate"
                            ],
                            "type": "string"
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "operating_margin_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "operating_result": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "orgnr": {
                            "type": "string"
                          },
                          "profit_margin_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "reason": {
                            "description": "Why the section is not complete.",
                            "type": "string"
                          },
                          "revenue": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "withheld": {
                            "description": "True when the data exists but is deliberately not delivered.",
                            "type": "boolean"
                          },
                          "year": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "completeness",
                          "kind",
                          "orgnr"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "companies"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Compare companies",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "compare_companies",
          "op": "company.compare",
          "scope": "network:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}": {
      "get": {
        "description": "Register identity of a Norwegian company (name, status, form, industry, address, purpose), its headline figures from the latest filing, auditor, credit-style ratings, an estimated value (marked as an estimate), attention flags and the latest register events. Every section says whether it is complete, unavailable or withheld.",
        "operationId": "company_profile",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "activity": {
                      "description": "Registered activity; free text with personal identifiers removed.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "address": {
                      "description": "Business address as one line.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "auditor": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "in_finanstilsynet_register": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "name": {
                          "description": "Audit firm name.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "orgnr": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "country": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "county": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "direct_owners_total": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "employees": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "estimated_value": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "confidence": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "currency": {
                          "description": "Always NOK.",
                          "type": "string"
                        },
                        "high": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "kind": {
                          "enum": [
                            "observed",
                            "estimate"
                          ],
                          "type": "string"
                        },
                        "low": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "mid": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        },
                        "year": {
                          "description": "Accounting year the estimate rests on.",
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "completeness",
                        "kind",
                        "currency"
                      ],
                      "type": "object"
                    },
                    "financials": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "currency": {
                          "description": "Filing currency; not always NOK. Absent when no filing is known.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "equity": {
                          "properties": {
                            "amount": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "currency": {
                              "description": "ISO 4217; the filing currency, not always NOK.",
                              "type": "string"
                            },
                            "kind": {
                              "enum": [
                                "observed",
                                "estimate"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "kind"
                          ],
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "operating_result": {
                          "properties": {
                            "amount": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "currency": {
                              "description": "ISO 4217; the filing currency, not always NOK.",
                              "type": "string"
                            },
                            "kind": {
                              "enum": [
                                "observed",
                                "estimate"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "kind"
                          ],
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "revenue": {
                          "properties": {
                            "amount": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "currency": {
                              "description": "ISO 4217; the filing currency, not always NOK.",
                              "type": "string"
                            },
                            "kind": {
                              "enum": [
                                "observed",
                                "estimate"
                              ],
                              "type": "string"
                            }
                          },
                          "required": [
                            "kind"
                          ],
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        },
                        "year": {
                          "description": "Accounting year of the latest filing.",
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "flags": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "items": {
                          "items": {
                            "properties": {
                              "date": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "detail": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "label": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "severity": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "severity"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness",
                        "items"
                      ],
                      "type": "object"
                    },
                    "founded": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "holdings_total": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "homepage": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "in_foretaksregisteret": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "industry": {
                      "properties": {
                        "code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "type": "object"
                    },
                    "municipality": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "org_form": {
                      "properties": {
                        "code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "type": "object"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "purpose": {
                      "description": "Registered purpose; free text with personal identifiers removed.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ratings": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "liquidity_rating": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "liquidity_ratio": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "profitability_rating": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "solidity_pct": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "solidity_rating": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "total_profitability_pct": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        },
                        "year": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "recent_events": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "items": {
                          "items": {
                            "properties": {
                              "date": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "type": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "type"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness",
                        "items"
                      ],
                      "type": "object"
                    },
                    "registered_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sector": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "share_capital": {
                      "properties": {
                        "amount": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "currency": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "shares": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        }
                      },
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "vat_registered": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "org_form",
                    "industry",
                    "financials",
                    "auditor",
                    "ratings",
                    "estimated_value",
                    "flags",
                    "recent_events"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company profile",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_profile",
          "op": "company.profile",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/accounts": {
      "get": {
        "description": "The company's own filed annual accounts, newest first: revenue, results, balance sheet and ratios, in the filing currency. Figures the register carries at the wrong scale are withheld, not corrected.",
        "operationId": "company_accounts",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          },
          {
            "description": "Filed years back, default 5.",
            "in": "query",
            "name": "years",
            "schema": {
              "description": "Filed years back, default 5.",
              "maximum": 8,
              "minimum": 1,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "years": {
                      "items": {
                        "properties": {
                          "annual_result": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "assets": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "currency": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "current_assets": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "current_debt": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "debt": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "equity": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "equity_ratio_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "filing_id": {
                            "description": "Regnskapsregisteret's id of the filing.",
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "fixed_assets": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "kind": {
                            "enum": [
                              "observed",
                              "estimate"
                            ],
                            "type": "string"
                          },
                          "long_term_debt": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "negative_equity": {
                            "type": [
                              "boolean",
                              "null"
                            ]
                          },
                          "net_finance": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "operating_cost": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "operating_margin_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "operating_result": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "payroll_cost": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "period_from": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "period_to": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "profit_margin_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "revenue": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "revenue_growth_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "year": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "kind",
                          "year"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "years",
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company accounts",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_accounts",
          "op": "company.accounts",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/benchmark": {
      "get": {
        "description": "Peers in the same industry and the company's rank among its industry section on the main ratios. Heavy: costs ten units. Says so when the rankings are still building.",
        "operationId": "company_benchmark",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "industry_section": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "peers": {
                      "items": {
                        "properties": {
                          "county": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "employees": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "industry": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": "string"
                          },
                          "revenue": {
                            "description": "Formatted text, in the language of the request locale.",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "same_industry_code": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "orgnr",
                          "name",
                          "same_industry_code"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "rankings": {
                      "items": {
                        "properties": {
                          "above_median": {
                            "type": "boolean"
                          },
                          "company": {
                            "description": "The company's value, formatted text.",
                            "type": "string"
                          },
                          "metric": {
                            "type": "string"
                          },
                          "of": {
                            "type": "integer"
                          },
                          "rank": {
                            "type": "integer"
                          },
                          "section_median": {
                            "description": "Median of the industry section, formatted text.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "metric",
                          "company",
                          "section_median",
                          "rank",
                          "of",
                          "above_median"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "peers",
                    "rankings",
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Peer benchmark",
        "x-biztrac": {
          "deadline_seconds": 30,
          "heavy": true,
          "mcp_tool": "peer_benchmark",
          "op": "company.benchmark",
          "scope": "network:read",
          "units": 10,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/credit": {
      "get": {
        "description": "biztrac's open credit score (1-100, higher is lower risk) with its band and the filed figures it rests on. A rule over the latest filed accounts, not a credit bureau rating; says so when no accounts exist.",
        "operationId": "company_credit",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "accounting_year": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "band": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "band_label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "basis": {
                      "properties": {
                        "audited": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "currency": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "current_ratio": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "equity": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "equity_ratio_pct": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "negative_equity": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "operating_margin_pct": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "revenue": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "total_assets": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      },
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "basis_source": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "computed_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "kind": {
                      "description": "The score is a rule over filed accounts: an estimate, not a bureau rating.",
                      "enum": [
                        "observed",
                        "estimate"
                      ],
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "period_to": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "scale": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "score": {
                      "description": "1-100, higher is lower risk.",
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company credit score",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_credit",
          "op": "company.credit",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/events": {
      "get": {
        "description": "Dated register events for a company (announcements, changes of roles, capital, address), newest first. Role changes name the people concerned; free text has personal identifiers removed.",
        "operationId": "company_events",
        "parameters": [
          {
            "description": "next_cursor of the previous page, unchanged.",
            "in": "query",
            "name": "cursor",
            "schema": {
              "description": "next_cursor of the previous page, unchanged.",
              "maxLength": 200,
              "type": "string"
            }
          },
          {
            "description": "Events per page, default 25.",
            "in": "query",
            "name": "limit",
            "schema": {
              "description": "Events per page, default 25.",
              "maximum": 40,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "events": {
                      "items": {
                        "properties": {
                          "date": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "description": {
                            "description": "Free text with personal identifiers removed.",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "field": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "new": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "old": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "type": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "name": {
                      "type": "string"
                    },
                    "next_cursor": {
                      "description": "Opaque cursor of the next page; absent on the last page.",
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "truncated": {
                      "description": "True when more events exist than this API serves (the bound is 40 per company).",
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "events",
                    "truncated"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company events",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_events",
          "op": "company.events",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/holdings": {
      "get": {
        "description": "What the company owns: its shareholdings in other companies from the shareholder register, and its group structure from Brønnøysund's konsernstruktur.",
        "operationId": "company_holdings",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "group_status": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "group_structure": {
                      "items": {
                        "properties": {
                          "level": {
                            "type": "integer"
                          },
                          "link_type": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": "string"
                          },
                          "parent_orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "stake": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "orgnr",
                          "name",
                          "level"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "shareholdings": {
                      "items": {
                        "properties": {
                          "country": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "industry": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pct": {
                            "description": "Ownership share, 0-100.",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "register_year": {
                            "description": "Income year of the shareholder register the row rests on.",
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "share_class": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "shares": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "type": {
                            "enum": [
                              "company",
                              "person"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "name",
                          "type"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "shareholdings_truncated": {
                      "type": "boolean"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "shareholdings",
                    "shareholdings_truncated",
                    "group_structure",
                    "group_status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company holdings",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_holdings",
          "op": "company.holdings",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/owners": {
      "get": {
        "description": "Direct shareholders from the shareholder register and the ultimate owners found by walking the ownership chains. Person owners are named; no identity number is ever returned.",
        "operationId": "company_owners",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "company_total_shares": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "direct_owners": {
                      "items": {
                        "properties": {
                          "country": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "industry": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pct": {
                            "description": "Ownership share, 0-100.",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "person_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "register_year": {
                            "description": "Income year of the shareholder register the row rests on.",
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "share_class": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "shares": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "type": {
                            "enum": [
                              "company",
                              "person"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "name",
                          "type"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "direct_owners_truncated": {
                      "type": "boolean"
                    },
                    "indirect_chains": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "register_years": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "share_covered_pct": {
                      "description": "How much of the company the ultimate owners listed account for, 0-100.",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "ultimate_owners": {
                      "items": {
                        "properties": {
                          "chain_ends_because": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "country": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "effective_pct": {
                            "description": "Effective ownership through the chain, 0-100.",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "kind": {
                            "enum": [
                              "company",
                              "person"
                            ],
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "person_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "steps": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "via": {
                            "description": "Names of the intermediaries on the chain.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "via"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "direct_owners",
                    "direct_owners_truncated",
                    "ultimate_owners"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company owners",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_owners",
          "op": "company.owners",
          "scope": "network:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/properties": {
      "get": {
        "description": "The real property the company holds (and, for scope group, its majority-controlled group) with model value estimates from the property source. When the property source is not connected the answer says so: what the company owns is then unknown, not nothing.",
        "operationId": "company_properties",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          },
          {
            "description": "company (default) or group: the company with every company it controls by majority.",
            "in": "query",
            "name": "scope",
            "schema": {
              "description": "company (default) or group: the company with every company it controls by majority.",
              "enum": [
                "company",
                "group"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "group": {
                      "properties": {
                        "holders": {
                          "items": {
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "orgnr": {
                                "type": "string"
                              },
                              "stake_pct": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "units": {
                                "type": "integer"
                              },
                              "value_mid_nok": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "orgnr",
                              "units"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "members": {
                          "type": "integer"
                        },
                        "units": {
                          "type": "integer"
                        },
                        "value": {
                          "properties": {
                            "completeness": {
                              "enum": [
                                "complete",
                                "partial",
                                "unavailable",
                                "not_found"
                              ],
                              "type": "string"
                            },
                            "confidence": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "currency": {
                              "description": "Always NOK.",
                              "type": "string"
                            },
                            "high": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "kind": {
                              "enum": [
                                "observed",
                                "estimate"
                              ],
                              "type": "string"
                            },
                            "low": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "mid": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "reason": {
                              "description": "Why the section is not complete.",
                              "type": "string"
                            },
                            "withheld": {
                              "description": "True when the data exists but is deliberately not delivered.",
                              "type": "boolean"
                            },
                            "year": {
                              "description": "Accounting year the estimate rests on.",
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "completeness",
                            "kind",
                            "currency"
                          ],
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "valued": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "members",
                        "units",
                        "valued",
                        "holders"
                      ],
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "pending": {
                      "description": "True while the source is still gathering; the figures are then partial.",
                      "type": "boolean"
                    },
                    "properties": {
                      "items": {
                        "properties": {
                          "address": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "built_year": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "holder": {
                            "description": "Name of the group company holding the unit, when not the company asked about.",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "holder_orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "label": {
                            "type": "string"
                          },
                          "last_sale_date": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "last_sale_price_nok": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "mortgages_nok": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "municipality": {
                            "type": "string"
                          },
                          "share_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "usable_m2": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "use": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "value": {
                            "description": "Model estimate of the company's share; an estimate, not a transaction price.",
                            "properties": {
                              "completeness": {
                                "enum": [
                                  "complete",
                                  "partial",
                                  "unavailable",
                                  "not_found"
                                ],
                                "type": "string"
                              },
                              "confidence": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "currency": {
                                "description": "Always NOK.",
                                "type": "string"
                              },
                              "high": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "kind": {
                                "enum": [
                                  "observed",
                                  "estimate"
                                ],
                                "type": "string"
                              },
                              "low": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "mid": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "reason": {
                                "description": "Why the section is not complete.",
                                "type": "string"
                              },
                              "withheld": {
                                "description": "True when the data exists but is deliberately not delivered.",
                                "type": "boolean"
                              },
                              "year": {
                                "description": "Accounting year the estimate rests on.",
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "completeness",
                              "kind",
                              "currency"
                            ],
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "value_basis": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "label",
                          "municipality"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "properties_truncated": {
                      "type": "boolean"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "scope": {
                      "enum": [
                        "company",
                        "group"
                      ],
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "description": "unavailable means the property source is not connected: what the company owns is unknown, not nothing.",
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "totals": {
                      "properties": {
                        "mortgage_to_value_pct": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "mortgages_nok": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "units": {
                          "type": "integer"
                        },
                        "usable_m2": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "value": {
                          "properties": {
                            "completeness": {
                              "enum": [
                                "complete",
                                "partial",
                                "unavailable",
                                "not_found"
                              ],
                              "type": "string"
                            },
                            "confidence": {
                              "type": [
                                "string",
                                "null"
                              ]
                            },
                            "currency": {
                              "description": "Always NOK.",
                              "type": "string"
                            },
                            "high": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "kind": {
                              "enum": [
                                "observed",
                                "estimate"
                              ],
                              "type": "string"
                            },
                            "low": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "mid": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "reason": {
                              "description": "Why the section is not complete.",
                              "type": "string"
                            },
                            "withheld": {
                              "description": "True when the data exists but is deliberately not delivered.",
                              "type": "boolean"
                            },
                            "year": {
                              "description": "Accounting year the estimate rests on.",
                              "type": [
                                "string",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "completeness",
                            "kind",
                            "currency"
                          ],
                          "type": [
                            "object",
                            "null"
                          ]
                        },
                        "valued": {
                          "type": "integer"
                        },
                        "valued_on": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "units",
                        "valued"
                      ],
                      "type": [
                        "object",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "scope",
                    "status",
                    "pending",
                    "properties",
                    "properties_truncated"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company properties",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_properties",
          "op": "company.properties",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/report-notes": {
      "get": {
        "description": "Text read from the company's filed annual report: the auditor's opinion with its findings, going-concern wording, the principles note and the notes you ask for by heading. Names of signatories appear; personal identifiers are removed from every text, and a text that cannot be cleaned is withheld.",
        "operationId": "company_report_notes",
        "parameters": [
          {
            "description": "Note headings or numbers to return in full, matched case-insensitively (for example revisor, fortsatt drift, 11); omit for the principles note and the index.",
            "explode": true,
            "in": "query",
            "name": "headings",
            "schema": {
              "description": "Note headings or numbers to return in full, matched case-insensitively (for example revisor, fortsatt drift, 11); omit for the principles note and the index.",
              "items": {
                "type": "string"
              },
              "maxItems": 8,
              "type": "array"
            },
            "style": "form"
          },
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          },
          {
            "description": "Accounting year of the filing; omit for the newest in the catalogue.",
            "in": "query",
            "name": "year",
            "schema": {
              "description": "Accounting year of the filing; omit for the newest in the catalogue.",
              "maximum": 2100,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "auditor_report": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "emphasis": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "findings": {
                          "items": {
                            "properties": {
                              "kind": {
                                "type": "string"
                              },
                              "page": {
                                "type": "integer"
                              },
                              "text": {
                                "description": "Quoted text with personal identifiers removed; null when it could not be made clean (withheld).",
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "topic": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "withheld": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "kind",
                              "page"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "going_concern": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "legal_remarks": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "opinion": {
                          "description": "clean, qualified, adverse, disclaimer or unknown.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "other_matter": {
                          "type": [
                            "integer",
                            "null"
                          ]
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "report_kind": {
                          "description": "audit or review.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness",
                        "findings"
                      ],
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "filing": {
                      "properties": {
                        "confirmed_by": {
                          "description": "Name of the person who confirmed the filing.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "confirmed_date": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "framework": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "group_accounts_attached": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "name": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "parent_company": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "period": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "small_company_rules": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        }
                      },
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "going_concern": {
                      "items": {
                        "properties": {
                          "note": {
                            "type": "integer"
                          },
                          "page": {
                            "type": "integer"
                          },
                          "phrase": {
                            "type": "string"
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "title": {
                            "type": "string"
                          },
                          "withheld": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "phrase",
                          "note",
                          "title",
                          "page"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "index": {
                      "items": {
                        "properties": {
                          "chars": {
                            "type": "integer"
                          },
                          "kind": {
                            "type": "string"
                          },
                          "number": {
                            "type": "integer"
                          },
                          "page": {
                            "type": "integer"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "number",
                          "title",
                          "page",
                          "kind",
                          "chars"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "report_notes": {
                      "items": {
                        "properties": {
                          "kind": {
                            "enum": [
                              "note",
                              "form"
                            ],
                            "type": "string"
                          },
                          "number": {
                            "type": "integer"
                          },
                          "page": {
                            "type": "integer"
                          },
                          "scope": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "text": {
                            "description": "Note text with personal identifiers removed; null when withheld.",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "title": {
                            "type": "string"
                          },
                          "truncated": {
                            "type": "boolean"
                          },
                          "withheld": {
                            "description": "True when the text could not be made clean of personal identifiers and is not delivered.",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "number",
                          "title",
                          "page",
                          "kind",
                          "truncated",
                          "withheld"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "year": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "years_in_catalogue": {
                      "items": {
                        "type": "integer"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "status",
                    "years_in_catalogue",
                    "going_concern",
                    "report_notes",
                    "index"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Annual report notes",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "annual_report_notes",
          "op": "company.report_notes",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/roles": {
      "get": {
        "description": "The registered roles of a company (managing director, board, auditor, signatories) with the names and birth years of the people who hold them. Former roles are listed only on request.",
        "operationId": "company_roles",
        "parameters": [
          {
            "description": "Also list resigned and deregistered roles.",
            "in": "query",
            "name": "include_former",
            "schema": {
              "description": "Also list resigned and deregistered roles.",
              "type": "boolean"
            }
          },
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "roles": {
                      "items": {
                        "properties": {
                          "entity": {
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "orgnr": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name"
                            ],
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "former": {
                            "type": "boolean"
                          },
                          "group": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "person": {
                            "properties": {
                              "birth_year": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "deceased": {
                                "type": "boolean"
                              },
                              "name": {
                                "type": "string"
                              },
                              "person_id": {
                                "description": "biztrac's own person id: stable while name, birth year and country are unchanged. Not an identity to store as a key.",
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "deceased"
                            ],
                            "type": [
                              "object",
                              "null"
                            ]
                          },
                          "role": {
                            "type": "string"
                          },
                          "role_code": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "role",
                          "former"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "roles_truncated": {
                      "type": "boolean"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "roles",
                    "roles_truncated"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company roles",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_roles",
          "op": "company.roles",
          "scope": "network:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/companies/{orgnr}/valuation": {
      "get": {
        "description": "biztrac's model estimate of the company's value (low, mid, high in NOK) over its filed accounts. It is an estimate, never a transaction price, and is withheld when the filed figures are.",
        "operationId": "company_valuation",
        "parameters": [
          {
            "description": "Nine-digit organisation number.",
            "in": "path",
            "name": "orgnr",
            "required": true,
            "schema": {
              "description": "Nine-digit organisation number.",
              "pattern": "^[0-9]{9}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "accounting_year": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "book_equity_value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "capitalized_earnings_value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "confidence": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "estimate": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "confidence": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "currency": {
                          "description": "Always NOK.",
                          "type": "string"
                        },
                        "high": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "kind": {
                          "enum": [
                            "observed",
                            "estimate"
                          ],
                          "type": "string"
                        },
                        "low": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "mid": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        },
                        "year": {
                          "description": "Accounting year the estimate rests on.",
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "completeness",
                        "kind",
                        "currency"
                      ],
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "explanation": {
                      "description": "How the estimate was built; free text with personal identifiers removed.",
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "method": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "normalized_ebit": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "orgnr": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "required_return": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "properties": {
                        "completeness": {
                          "enum": [
                            "complete",
                            "partial",
                            "unavailable",
                            "not_found"
                          ],
                          "type": "string"
                        },
                        "reason": {
                          "description": "Why the section is not complete.",
                          "type": "string"
                        },
                        "withheld": {
                          "description": "True when the data exists but is deliberately not delivered.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "completeness"
                      ],
                      "type": "object"
                    },
                    "zscore": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "zscore_zone": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "orgnr",
                    "name",
                    "status"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Company valuation",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "company_valuation",
          "op": "company.valuation",
          "scope": "companies:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/connections": {
      "get": {
        "description": "Finds how two companies or people are connected through ownership, roles, shared auditors and shared business addresses, up to four hops. Heavy: costs ten units. An endpoint that cannot be resolved answers not_found with candidates.",
        "operationId": "network_connection",
        "parameters": [
          {
            "description": "A company or person: name, organisation number or node id.",
            "in": "query",
            "name": "from",
            "required": true,
            "schema": {
              "description": "A company or person: name, organisation number or node id.",
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "The other company or person.",
            "in": "query",
            "name": "to",
            "required": true,
            "schema": {
              "description": "The other company or person.",
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "connected": {
                      "type": "boolean"
                    },
                    "edges": {
                      "items": {
                        "properties": {
                          "from": {
                            "type": "string"
                          },
                          "pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "register_year": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "relationship_type": {
                            "type": "string"
                          },
                          "share_class": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "source": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "to": {
                            "type": "string"
                          },
                          "valid_from": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "valid_to": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "from",
                          "to",
                          "relationship_type"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "from": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "node_id": {
                          "type": "string"
                        },
                        "orgnr": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "node_id"
                      ],
                      "type": "object"
                    },
                    "from_owns_to_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "nodes": {
                      "items": {
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "node_id": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "type": {
                            "enum": [
                              "company",
                              "person"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "node_id",
                          "name",
                          "type"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "paths": {
                      "items": {
                        "properties": {
                          "chain": {
                            "description": "Names along the path.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "direction": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "effective_pct": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "hops": {
                            "type": "integer"
                          },
                          "kind": {
                            "type": "string"
                          },
                          "narrative": {
                            "description": "A sentence describing the path; personal identifiers removed.",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "strength": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "kind",
                          "strength",
                          "hops",
                          "chain"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "paths_truncated": {
                      "type": "boolean"
                    },
                    "paths_without_edge_records": {
                      "type": "boolean"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "shared": {
                      "properties": {
                        "addresses": {
                          "description": "Business addresses shared by companies on the paths.",
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "auditors": {
                          "items": {
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "node_id": {
                                "type": "string"
                              },
                              "orgnr": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "node_id"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "intermediaries": {
                          "items": {
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "node_id": {
                                "type": "string"
                              },
                              "orgnr": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "node_id"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        },
                        "persons": {
                          "items": {
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "node_id": {
                                "type": "string"
                              },
                              "role_a": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "role_b": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "node_id"
                            ],
                            "type": "object"
                          },
                          "type": "array"
                        }
                      },
                      "required": [
                        "persons",
                        "intermediaries",
                        "auditors",
                        "addresses"
                      ],
                      "type": "object"
                    },
                    "shortest_hops": {
                      "description": "Hops of the shortest path, within the four-hop bound; absent when not connected.",
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "to": {
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "node_id": {
                          "type": "string"
                        },
                        "orgnr": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "node_id"
                      ],
                      "type": "object"
                    },
                    "to_owns_from_pct": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "from",
                    "to",
                    "connected",
                    "paths",
                    "paths_truncated",
                    "nodes",
                    "edges",
                    "paths_without_edge_records",
                    "shared"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Find connection",
        "x-biztrac": {
          "deadline_seconds": 30,
          "heavy": true,
          "mcp_tool": "find_connection",
          "op": "network.connection",
          "scope": "network:read",
          "units": 10,
          "version": 1
        }
      }
    },
    "/v1/openapi.json": {
      "get": {
        "operationId": "openapi",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            },
            "description": "The OpenAPI 3.1 document of the v1 contract."
          }
        },
        "security": [],
        "summary": "This document"
      }
    },
    "/v1/persons/{id}": {
      "get": {
        "description": "A person known to the registers by biztrac's person id: name, registered roles and shareholdings. No identity number, address, email or phone is ever returned. The id is a lookup key, not an identity to store.",
        "operationId": "person_profile",
        "parameters": [
          {
            "description": "biztrac's person id, from company.roles or company.owners.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "description": "biztrac's person id, from company.roles or company.owners.",
              "pattern": "^[A-Za-z0-9_-]{8,64}$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "estimated_shareholding_value": {
                      "description": "Estimated value of the person's shareholdings; an estimate.",
                      "properties": {
                        "amount": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "currency": {
                          "description": "ISO 4217; the filing currency, not always NOK.",
                          "type": "string"
                        },
                        "kind": {
                          "enum": [
                            "observed",
                            "estimate"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "person_id": {
                      "type": "string"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "roles": {
                      "items": {
                        "properties": {
                          "company": {
                            "type": "string"
                          },
                          "former": {
                            "type": "boolean"
                          },
                          "orgnr": {
                            "type": "string"
                          },
                          "role": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "role",
                          "company",
                          "orgnr",
                          "former"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "roles_truncated": {
                      "type": "boolean"
                    },
                    "shareholdings": {
                      "items": {
                        "properties": {
                          "country": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "industry": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "orgnr": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "pct": {
                            "description": "Ownership share, 0-100.",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "register_year": {
                            "description": "Income year of the shareholder register the row rests on.",
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "share_class": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "shares": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "type": {
                            "enum": [
                              "company",
                              "person"
                            ],
                            "type": "string"
                          }
                        },
                        "required": [
                          "name",
                          "type"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "shareholdings_truncated": {
                      "type": "boolean"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "person_id",
                    "name",
                    "shareholdings",
                    "shareholdings_truncated",
                    "roles",
                    "roles_truncated"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found: the company or person is unknown. Free."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "source_unavailable: the operation ran but a required source is off. Charged."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Person profile",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "person_profile",
          "op": "person.profile",
          "scope": "network:read",
          "units": 1,
          "version": 1
        }
      }
    },
    "/v1/usage": {
      "get": {
        "description": "This month's units used against the customer's allowance, when it resets, and the customer's keys. Free, and available to a suspended customer.",
        "operationId": "usage",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "allowance": {
                      "description": "Units the customer may use this month; there is no overage.",
                      "type": "integer"
                    },
                    "completeness": {
                      "description": "Whether the answer is whole.",
                      "enum": [
                        "complete",
                        "partial",
                        "unavailable",
                        "not_found"
                      ],
                      "type": "string"
                    },
                    "customer": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "orgnr": {
                          "type": "string"
                        },
                        "plan": {
                          "type": "string"
                        },
                        "status": {
                          "enum": [
                            "active",
                            "suspended",
                            "closed"
                          ],
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "orgnr",
                        "name",
                        "status",
                        "plan"
                      ],
                      "type": "object"
                    },
                    "keys": {
                      "description": "The customer's keys that can authenticate; the secret is never shown.",
                      "items": {
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "last_used_at": {
                            "format": "date-time",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name": {
                            "type": "string"
                          },
                          "prefix": {
                            "description": "The first characters of the key after bzk_, as shown on the settings page.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "prefix"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "month": {
                      "description": "The allowance month, YYYY-MM (UTC).",
                      "type": "string"
                    },
                    "notes": {
                      "description": "Plain-language explanation of any gap.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "op": {
                      "description": "Operation id.",
                      "type": "string"
                    },
                    "op_version": {
                      "description": "Additive version of the operation within /v1.",
                      "type": "integer"
                    },
                    "request_id": {
                      "description": "Identifier of this request; quote it in support requests.",
                      "type": "string"
                    },
                    "resets_at": {
                      "description": "When the allowance resets.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "retrieved_at": {
                      "description": "When the answer was produced.",
                      "format": "date-time",
                      "type": "string"
                    },
                    "sources": {
                      "description": "One entry per section with its origin and date.",
                      "items": {
                        "properties": {
                          "completeness": {
                            "enum": [
                              "complete",
                              "partial",
                              "unavailable",
                              "not_found"
                            ],
                            "type": "string"
                          },
                          "section": {
                            "description": "Name of the answer section this source covers.",
                            "type": "string"
                          },
                          "source": {
                            "description": "Origin of the data, e.g. a register name.",
                            "type": "string"
                          },
                          "source_date": {
                            "description": "Date of the underlying data (YYYY-MM-DD), absent when unknown.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "section",
                          "source"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "used": {
                      "description": "Units used this month.",
                      "type": "integer"
                    }
                  },
                  "required": [
                    "request_id",
                    "op",
                    "op_version",
                    "retrieved_at",
                    "completeness",
                    "sources",
                    "customer",
                    "month",
                    "used",
                    "allowance",
                    "resets_at",
                    "keys"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "The answer, in the envelope with request_id, completeness and sources.",
            "headers": {
              "X-Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_request: not JSON, unknown field, missing field, bad value (details.field). Free."
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid_key: missing, malformed, unknown, expired or revoked key. Free."
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "insufficient_scope or customer_suspended. Free."
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "rate_limited (Retry-After) or allowance_exhausted (details.used, allowance, resets_at). Free."
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal: the reservation is refunded."
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable: nothing charged."
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Usage",
        "x-biztrac": {
          "deadline_seconds": 10,
          "heavy": false,
          "mcp_tool": "",
          "op": "usage",
          "scope": "",
          "units": 0,
          "version": 1
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.biztrac.no"
    }
  ],
  "x-error-catalogue": [
    {
      "charge": "free",
      "code": "invalid_request",
      "http": 400,
      "when": "not JSON, unknown field, missing field, bad value; details.field names it"
    },
    {
      "charge": "free",
      "code": "invalid_key",
      "http": 401,
      "when": "missing, malformed, unknown, expired or revoked key; keys in the query string are not read"
    },
    {
      "charge": "free",
      "code": "insufficient_scope",
      "http": 403,
      "when": "the key (narrowed by the plan) lacks the operation's scope; details.scope"
    },
    {
      "charge": "free",
      "code": "customer_suspended",
      "http": 403,
      "when": "the customer is not active; only GET /v1/usage still answers"
    },
    {
      "charge": "free",
      "code": "not_found",
      "http": 404,
      "when": "the company or person does not exist, or an endpoint could not be resolved"
    },
    {
      "charge": "charged",
      "code": "source_unavailable",
      "http": 422,
      "when": "the operation ran but a required source is off; the work was done"
    },
    {
      "charge": "free",
      "code": "rate_limited",
      "http": 429,
      "when": "per-key bucket; Retry-After seconds"
    },
    {
      "charge": "free",
      "code": "allowance_exhausted",
      "http": 429,
      "when": "the monthly allowance is used up; details.used, details.allowance, details.resets_at; there is no overage"
    },
    {
      "charge": "refunded",
      "code": "register_error",
      "http": 502,
      "when": "a live register read failed"
    },
    {
      "charge": "refunded",
      "code": "internal",
      "http": 500,
      "when": "adapter panic or deadline"
    },
    {
      "charge": "free",
      "code": "unavailable",
      "http": 503,
      "when": "the accounts or ledger store is down, or the operation is switched off; nothing was charged"
    }
  ]
}
