CompanySearchResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bumit-ai/json-schema/bumit-ai-company-search-result-schema.json",
  "title": "CompanySearchResult",
  "x-generated": "2026-11-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/bumit-ai-v1-openapi.json#/components/schemas/CompanySearchResult",
  "type": "object",
  "required": [
    "status",
    "query",
    "count",
    "results",
    "disclaimer"
  ],
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "query": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "enum": [
        "ZEFIX"
      ]
    },
    "served_from_cache": {
      "type": "boolean"
    },
    "count": {
      "type": "integer"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "attribution": {
            "$ref": "#/$defs/Attribution"
          },
          "bumit_derived_values": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/DerivedValue"
            }
          }
        },
        "additionalProperties": true
      }
    },
    "disclaimer": {
      "$ref": "#/$defs/Disclaimer"
    },
    "coverage_note": {
      "type": "string"
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    }
  },
  "$defs": {
    "Attribution": {
      "type": "object",
      "required": [
        "source",
        "retrieved_at",
        "legal_effect",
        "guaranteed"
      ],
      "description": "Source attribution for Zefix-derived facts. Zefix data has no legal effect and is provided without guarantee.",
      "properties": {
        "source": {
          "type": "string",
          "enum": [
            "ZEFIX"
          ]
        },
        "source_label": {
          "type": "string"
        },
        "source_reference": {
          "type": "string"
        },
        "source_record_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_url": {
          "type": [
            "string",
            "null"
          ]
        },
        "retrieved_at": {
          "type": "string",
          "format": "date-time"
        },
        "source_timestamp": {
          "type": [
            "string",
            "null"
          ]
        },
        "legal_effect": {
          "type": "boolean",
          "enum": [
            false
          ]
        },
        "guaranteed": {
          "type": "boolean",
          "enum": [
            false
          ]
        },
        "notices": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "DerivedValue": {
      "type": "object",
      "required": [
        "field",
        "source",
        "source_value",
        "bumit_derived_value",
        "modified"
      ],
      "description": "A value BUMIT derived from Zefix data. Not a Zefix-published field.",
      "properties": {
        "field": {
          "type": "string"
        },
        "source": {
          "type": "string",
          "enum": [
            "ZEFIX"
          ]
        },
        "source_value": {},
        "bumit_derived_value": {},
        "modified": {
          "type": "boolean",
          "enum": [
            true
          ]
        },
        "derivation": {
          "type": "string"
        }
      }
    },
    "Disclaimer": {
      "type": "object",
      "required": [
        "legal_effect",
        "source_guarantees_data",
        "statement"
      ],
      "properties": {
        "legal_effect": {
          "type": "boolean",
          "enum": [
            false
          ]
        },
        "source_guarantees_data": {
          "type": "boolean",
          "enum": [
            false
          ]
        },
        "bumit_derived_fields_present": {
          "type": "boolean"
        },
        "statement": {
          "type": "string"
        },
        "notices": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "Meta": {
      "type": "object",
      "required": [
        "service",
        "api_version",
        "trace_id",
        "generated_at"
      ],
      "properties": {
        "service": {
          "type": "string"
        },
        "api_version": {
          "type": "string"
        },
        "trace_id": {
          "type": "string",
          "format": "uuid"
        },
        "generated_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    }
  }
}