Data Models Reference

This page documents the common data structures used across all Emmi API endpoints.

Request Structure

All endpoints accept an array of entities to support batch processing:

[
  {
    "entity_info": { ... },
    "data": [ ... ]
  }
]

---

entity_info Object

The entity_info object contains asset identification and classification information.

Common Fields (All Asset Types)

Field	Type	Required	Description
identifier	string	Yes	Unique entity identifier
name	string	No	Entity name
asset_type	string	Yes	One of: equity, debt, infrastructure, property
country	string	Yes	Country of operation

Industry Classification Fields

Field	Equity	Debt	Infrastructure	Property	Description
industry_classification_system	Required	Required	Required	-	Classification system (e.g., "rbics", "gics", "anzsic")
industry	Required	Required	Required	-	Industry classification
sector	Optional	Optional	Optional	-	Sector classification

Asset-Specific Fields

Debt Assets

Field	Type	Required	Description
maturity_date	string	Yes	Maturity date (format: YYYY-MM-DD)

Property Assets

Field	Type	Required	Description
state	string	Yes	State/region
net_lettable_area	number	Yes	Net lettable area in square meters
building_type	string	Yes	Building type (e.g., office, retail, industrial, residential)

data Array

The data array contains historical information by year. Each entry must include:

• year (required): Integer year value
• emissions Emissions object
• financials Financial object

---

emissions Object

Emissions data in tonnes of CO2 equivalent (tCO2e).

Field	Type	Description
scope1	number	Direct GHG emissions
scope2	number	Indirect emissions from purchased energy
scope3	number	Other indirect emissions in value chain
underlying_scope1	number	Direct GHG emissions of underlying entity (for debt)
underlying_scope2	number	Indirect emissions from purchased energy of underlying entity (for debt)
underlying_scope3	number	Other indirect emissions in value chain of underlying entity (for debt)

---

financials Object

Financial metrics vary by asset type. The required fields are the absolute minimum required to produce a result. We recommend providing as many optional fields as possible to improve the quality of results returned from our endpoints. All fields are for the entity in it's entirety, not some attributable portion like "owned" or "spend".

Equity Assets

Field	Required	Optional	Description
currency	✓		Currency code (e.g., USD, EUR, GBP, AUD)
revenue	✓		Annual revenue
total_assets	✓		Total assets
ebitda	✓		Earnings before interest, taxes, depreciation, amortization
total_debt	✓		Total debt
cap_ex		✓	Capital expenditures
cash		✓	Cash and cash equivalents
dividends		✓	Dividend payments
enterprise_value		✓	Enterprise value
evic		✓	Enterprise value including cash
cash_flow_operations		✓	Cash flow from operations
current_liabilities		✓	Current liabilities
ebit		✓	Earnings before interest and taxes
interest		✓	Interest expense
employees		✓	Number of employees
nppe		✓	Net property, plant & equipment
gppe		✓	Gross property, plant & equipment
market_cap		✓	Market capitalization
debt		✓	Total debt
price_to_earnings		✓	Price-to-earnings ratio
net_assets		✓	Net assets

Debt Assets

Field	Required	Optional	Description
currency	✓		Currency code (e.g., USD, EUR, GBP, AUD)
total_debt	✓		Debt of the bond or current outstanding amount
revenue	✓		Annual revenue of underlying entity
total_assets	✓		Total assets of underlying entity
ebitda	✓		Earnings before interest, taxes, depreciation, amortization of underlying entity
total_debt		✓	Total debt of underlying entity
enterprise_value		✓	Enterprise value of underlying entity
evic		✓	Enterprise value including cash of underlying entity
cash		✓	Cash and cash equivalents of underlying entity
current_liabilities		✓	Current liabilities of underlying entity
cash_flow_operations		✓	Cash flow from operations of underlying entity
ebit		✓	Earnings before interest and taxes of underlying entity
interest		✓	Interest expense of underlying entity
employees		✓	Number of employees of underlying entity
total_liabilities		✓	Total liabilities of underlying entity
market_cap		✓	Market capitalization of underlying entity
price_to_earnings		✓	Price-to-earnings ratio of underlying entity
dividends		✓	Dividend payments of underlying entity
net_assets		✓	Net assets of underlying entity

Infrastructure Assets

Field	Required	Optional	Description
currency	✓		Currency code (e.g., USD, EUR, GBP, AUD)
market_value	✓		Market value of asset
book_value	✓		Book value of asset
operating_cash_flow	✓		Operating cash flow
ebitda	✓		Earnings before interest, taxes, depreciation, amortization
gearing_ratio	✓		Gearing ratio (debt to equity)
remaining_life	✓		Remaining useful life (years)
discount_rate	✓		Discount rate for valuation

Property Assets

Field	Required	Optional	Description
currency	✓		Currency code (e.g., USD, EUR, GBP, AUD)
net_operating_income	✓		Net operating income
market_value	✓		Market value of property
book_value	✓		Book value of property
operating_cash_flow	✓		Operating cash flow
gearing_ratio	✓		Gearing ratio (debt to equity)
remaining_life	✓		Remaining useful life (years)
discount_rate	✓		Discount rate for valuation
ebitda		✓	Earnings before interest, taxes, depreciation, amortization
energy_rating		✓	Energy efficiency rating (numeric)
energy_rating_system		✓	Rating system used (e.g., NABERS, ENERGY STAR)

---

Best Practices

1. More data is better: Optional fields improve model accuracy
2. Consistency: Use consistent units and currency across all years
3. Multiple years: Provide 2-3 years of historical data when available
4. Reported emissions: Include actual emissions when available to anchor estimates