Foundation in Formation | The Open Company Data Standard
Foundation Transition Pro Access

STANDARD v1.1

The schema definition for normalized corporate registry data. Version 1.1 emphasizes verifiability through cryptographic hashing.

Core Schema Definition

Central.Enterprises normalizes diverse jurisdictional formats into a single, predictable JSON object.

{
  "$schema": "https://central.enterprises/schemas/v1.1/company.json",
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string",
      "format": "uuid",
      "description": "Immutable internal ID, persistent across snapshots."
    },
    "jurisdiction": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "ISO 3166-1 alpha-2 code (e.g., ES, US)."
    },
    "reg_number": {
      "type": "string",
      "description": "Official local identifier (NIF, EIN, CRN)."
    },
    "name": {
      "type": "string",
      "description": "Registered legal name."
    },
    "status": {
      "type": "string",
      "enum": ["active", "dissolved", "liquidation", "unknown"],
      "default": "unknown"
    },
    "founding_date": {
      "type": "string",
      "format": "date"
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of extraction."
    },
    "record_hash": {
      "type": "string",
      "description": "SHA-256 hash of the source record for verifiability."
    },
    "source_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": ["entity_id", "jurisdiction", "name", "reg_number", "retrieved_at"]
}

Manifest Protocol

Every dataset download includes a `dataset_manifest.json` for integrity verification.

{
  "build_id": "20260103-ES-FULL",
  "generated_at": "2026-01-03T09:00:00Z",
  "files": [
    {
      "name": "companies.csv",
      "rows": 10420,
      "sha256": "a1b2c3d4..."
    }
  ],
  "maintainer": "Central.Enterprises Foundation"
}