entity dossier schema documentation

overview

this document provides comprehensive documentation for the entity dossier json schema used to profile companies and organizations participating in the data center industry. entity dossiers provide deep profiles of hyperscalers, operators, financial sponsors, utilities, construction firms, and technology vendors.

schema versions

• current version: 1.0 (october 2025)
• file locations: /support/datacenters/entities/{category}/{entity_name}.json
• total entities: 37 profiled entities
• schema definition: /support/datacenters/entities/ENTITY_DOSSIER_SCHEMA.json

entity types

top-level structure

required fields

optional fields

overview object

example:

{
  "overview": {
    "founded": "1975",
    "headquarters": {
      "city": "Redmond",
      "state": "Washington",
      "country": "United States"
    },
    "publicCompany": true,
    "ticker": "MSFT",
    "exchange": "NASDAQ",
    "marketCapUSD": 3800000000000,
    "employeesTotal": 228000,
    "website": "https://www.microsoft.com",
    "description": "Microsoft Corporation is a multinational technology company...",
    "businessModel": "Microsoft operates a diversified business model..."
  }
}

data center profile object

global footprint

us footprint

major location object:

{
  "location": "Northern Virginia",
  "capacityMW": 150,
  "status": "Operational",
  "significance": "Microsoft's largest US data center region"
}

specialization

strategy object

power strategy object

public commitment object

{
  "announcement": "Fiscal Year 2025 AI Data Center Investment",
  "date": "2025-01-03",
  "valueUSD": 80000000000,
  "scope": "AI-enabled data center construction globally",
  "timeline": "Through June 30, 2025"
}

financials object

partnerships object

power providers

power partnership object:

{
  "partner": "Constellation Energy",
  "type": "nuclear",
  "capacityMW": 835,
  "details": "20-year power purchase agreement for restart of Three Mile Island Unit 1",
  "announcementDate": "2024-09-20"
}

type enum: “nuclear”, “renewable”, “utility”, “microgrid”

construction partners

{
  "contractor": "DPR Construction",
  "relationship": "Preferred contractor for major U.S. projects",
  "projects": ["Equinix DA11 Dallas", "Equinix Ashburn North Campus"]
}

technology vendors

{
  "vendor": "NVIDIA",
  "category": "AI Hardware / GPUs",
  "details": "Primary GPU supplier for Azure AI infrastructure"
}

financial partnerships

{
  "partner": "Brookfield Asset Management",
  "type": "Renewable Energy Investment Partnership",
  "valueUSD": 10000000000,
  "details": "Joint investment in 10.5 GW renewable energy capacity"
}

key executives array

competitive analysis object

timeline array

timeline event object:

example:

{
  "date": "2024-10",
  "event": "$15B xScale Joint Venture with GIC and CPP Investments",
  "category": "partnership",
  "significance": "Nearly triples xScale program investment capital",
  "impactUSD": 15000000000
}

project references array

links entity to projects in main database:

{
  "projectName": "Equinix DC12 Ashburn",
  "state": "Virginia",
  "role": "operator",
  "capacityMW": 4
}

role enum: “sponsor”, “operator”, “tenant”, “investor”, “contractor”, “customer”

sources array

same structure as project schema sources:

{
  "url": "https://www.example.com/article",
  "title": "Article Title",
  "date": "2024-01-15",
  "publisher": "Publisher Name",
  "type": "sec-filing"
}

type enum: “company-website”, “sec-filing”, “press-release”, “news”, “industry-publication”, “analyst-report”, “conference-presentation”, “linkedin”, “wikipedia”

entity type specific patterns

hyperscaler dossier

emphasizes:

• global data center footprint
• cloud infrastructure strategy
• ai/ml investments
• power partnerships (especially nuclear)
• capex commitments

operator dossier

emphasizes:

• portfolio composition (retail vs wholesale)
• customer mix and enterprise relationships
• geographic footprint
• xscale/hyperscale capabilities
• interconnection ecosystem

financial sponsor dossier

emphasizes:

• portfolio companies
• total aum in data center sector
• recent deals and valuations
• exit strategies
• investment thesis

validation checklist

when creating entity dossiers:

• entityType matches directory location
• entityName is official company name
• overview.description provides comprehensive context
• dataCenterProfile populated for relevant entity types
• powerStrategy documented for major operators/hyperscalers
• minimum 5 sources with diverse types
• keyExecutives includes C-level leadership
• timeline captures major milestones
• competitiveAnalysis provides balanced swot
• lastUpdated reflects most recent information
• all financial figures in full USD (not abbreviated)
• all dates in ISO 8601 format
• projectReferences links to actual database projects

for questions or schema change proposals, reference the main data center database documentation.