AU Climate Disclosure API

Base URL: https://api.techcompass.com.au. DCCEEW National Greenhouse Accounts (NGA) emission factors for AASB S2, TCFD, and Scope 1/2/3 reporting. Free tier. Annual update.

About this Dataset

The AU Climate Disclosure API exposes Australian National Greenhouse Accounts (NGA) emission factors published by the Department of Climate Change, Energy, the Environment and Water (DCCEEW). These are the government-mandated factors used for calculating greenhouse gas emissions under the National Greenhouse and Energy Reporting Act 2007 (NGER Act), and are the correct factors for AASB S2 and ISSB IFRS S2 climate disclosure obligations.

What are NGA emission factors?

NGA factors convert energy consumption or activity data into carbon-dioxide-equivalent (CO2-e) emissions. They cover electricity consumption by state and territory, stationary combustion (natural gas, diesel, LPG, coal, and others), and transport fuels. Every Australian company reporting under NGER or making climate disclosures under AASB S2 is required to use these factors — not third-party estimates.

AASB S2 and ISSB IFRS S2 context

AASB S2 Climate-related Disclosures became mandatory for large Australian entities from 1 January 2025 (Group 1) and extends to Group 2 entities (~3,000 entities) from 1 July 2026. Scope 2 emissions disclosures require the location-based method using the state/territory grid emission factor published in the current NGA workbook. This API provides those factors in machine-readable form, removing the manual step of downloading and parsing the DCCEEW Excel workbook.

Update frequency

DCCEEW publishes a new NGA Factors workbook annually, typically in January or February. The Tech Compass pipeline ingests the updated workbook from GCS staging within 24 hours of upload. The /versions endpoint shows which workbook year is currently loaded and its publication_reference.

Licensing

NGA Factors data is published by the Commonwealth of Australia under Creative Commons Attribution 4.0 International (CC BY 4.0). Commercial use is permitted with attribution. The data_lineage.attribution field in every response carries the required attribution string.

Authentication & Tiers

All endpoints require an API key passed as a header:

Authorization: ApiKey tc_live_<your_key>

Endpoint	Free tier	Professional
Query Factors (`/nga-factors`)	Yes	Yes
List Versions (`/nga-factors/versions`)	Yes	Yes

Both endpoints are available on all tiers. Professional provides 500,000 calls/month vs 10,000 on Free.

Emission Factor Object

Each result in the results array contains:

Field	Type	Description
`state`	string	State or territory code (`NSW`, `VIC`, `QLD`, `SA`, `WA`, `TAS`, `NT`, `National`)
`fuel_type`	string	Fuel or energy type as labelled in the NGA workbook (e.g. `Electricity`, `Natural Gas`, `Diesel`)
`year`	integer	Calendar year the factor applies to
`emission_factor`	float	CO2-e per unit (see `unit`)
`unit`	string	Unit for the factor (e.g. `kg CO2-e/kWh`, `kg CO2-e/GJ`, `kg CO2-e/L`)
`publication_reference`	string	Full title of the source workbook (e.g. `National Greenhouse Accounts Factors 2025`)
`workbook_version`	string	Version identifier for the ingested workbook file

Data lineage block

Every response includes a data_lineage block for audit and disclosure purposes:

{
  "data_lineage": {
    "source": "DCCEEW National Greenhouse Accounts Factors 2025",
    "source_url": "https://www.dcceew.gov.au/climate-change/publications/national-greenhouse-accounts-factors",
    "retrieved_at": "2026-07-07T10:00:00Z",
    "request_id": "a1b2c3d4-...",
    "licence": "CC BY 4.0",
    "attribution": "© Commonwealth of Australia (Department of Climate Change, Energy, the Environment and Water) CC BY 4.0",
    "publication_reference": "National Greenhouse Accounts Factors 2025",
    "workbook_version": "2025"
  }
}

Valid State Codes

Code	State / Territory	2025 Electricity Factor
`NSW`	New South Wales	0.64 kg CO2-e/kWh
`VIC`	Victoria	0.78 kg CO2-e/kWh
`QLD`	Queensland	0.67 kg CO2-e/kWh
`SA`	South Australia	0.22 kg CO2-e/kWh
`WA`	Western Australia	0.61 kg CO2-e/kWh
`TAS`	Tasmania	0.20 kg CO2-e/kWh
`NT`	Northern Territory	0.56 kg CO2-e/kWh
`ACT`	Australian Capital Territory	See note below
`National`	National average	0.64 kg CO2-e/kWh

ACT grid note: The ACT does not have a separate entry in the NGA workbook. The ACT electricity grid is supplied via NSW infrastructure, so the NSW emission factor (0.64 kg CO2-e/kWh) applies for ACT Scope 2 calculations. Querying state=ACT automatically returns NSW factors and includes a note field in the response explaining this grid relationship.

Endpoints

GET /v1/au/climate/nga-factors

Query emission factors. All parameters are optional — omit all to return the full dataset (subject to limit).

Parameter	Type	Default	Description
`state`	string	—	State/territory code. See valid codes above. `ACT` redirects to NSW with a disclosure note.
`fuel_type`	string	—	Case-insensitive partial match against fuel type name (e.g. `electric`, `natural gas`, `diesel`)
`year`	integer	—	Calendar year (e.g. `2025`). Returns 404 with available years if the requested year is not in the database.
`limit`	integer	100	Maximum results to return (1–500)

# All electricity factors for 2025
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?fuel_type=electricity&year=2025" \
  -H "Authorization: ApiKey tc_live_<your_key>"

{
  "data": {
    "count": 8,
    "results": [
      {
        "state": "NSW",
        "fuel_type": "Electricity",
        "year": 2025,
        "emission_factor": 0.64,
        "unit": "kg CO2-e/kWh",
        "publication_reference": "National Greenhouse Accounts Factors 2025",
        "workbook_version": "2025"
      },
      {
        "state": "VIC",
        "fuel_type": "Electricity",
        "year": 2025,
        "emission_factor": 0.78,
        "unit": "kg CO2-e/kWh",
        "publication_reference": "National Greenhouse Accounts Factors 2025",
        "workbook_version": "2025"
      }
    ]
  },
  "meta": { "request_id": "a1b2c3d4-..." },
  "data_lineage": { ... }
}

# Scope 2 factor for a VIC facility
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?state=VIC&fuel_type=electricity" \
  -H "Authorization: ApiKey tc_live_<your_key>"

# ACT query — returns NSW factors with disclosure note
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?state=ACT&fuel_type=electricity" \
  -H "Authorization: ApiKey tc_live_<your_key>"

{
  "data": {
    "count": 1,
    "note": "ACT does not have a separate entry in the NGA workbook. The ACT electricity grid is supplied via NSW infrastructure — NSW emission factors apply for ACT Scope 2 calculations.",
    "results": [
      {
        "state": "NSW",
        "fuel_type": "Electricity",
        "year": 2025,
        "emission_factor": 0.64,
        "unit": "kg CO2-e/kWh",
        ...
      }
    ]
  },
  ...
}

GET /v1/au/climate/nga-factors/versions

List available NGA workbook versions and the years of data each contains. Use this to confirm which workbook version is loaded before generating a disclosure report.

curl "https://api.techcompass.com.au/v1/au/climate/nga-factors/versions" \
  -H "Authorization: ApiKey tc_live_<your_key>"

{
  "data": {
    "count": 1,
    "versions": [
      {
        "workbook_version": "2025",
        "publication_reference": "National Greenhouse Accounts Factors 2025",
        "years_available": [2025],
        "year_min": 2025,
        "year_max": 2025
      }
    ]
  },
  "meta": { "request_id": "a1b2c3d4-..." },
  "data_lineage": {
    "source": "DCCEEW National Greenhouse Accounts Factors 2025",
    ...
  }
}

Disclosure tip: Include workbook_version and publication_reference from the data_lineage block in your climate disclosure reports. This satisfies the AASB S2 requirement to identify the source and version of emission factors used.

Error Reference

Status	Meaning
401	Missing or invalid API key
422	Invalid `state` parameter — response includes `valid_states` array
404	Requested `year` not in database — response includes `available_years` array
429	Monthly API call quota exhausted

# 422 example — invalid state
{
  "detail": {
    "error": "Invalid state 'XYZ'. Must be one of: ['ACT', 'NSW', 'NT', 'National', 'QLD', 'SA', 'TAS', 'VIC', 'WA']",
    "valid_states": ["ACT", "NSW", "NT", "National", "QLD", "SA", "TAS", "VIC", "WA"]
  }
}

# 404 example — year not loaded
{
  "detail": {
    "error": "No factors found for year 2022.",
    "available_years": [2025]
  }
}

Common Use Cases

1. AASB S2 Scope 2 electricity emissions (location-based method)

Who uses this: CFOs, sustainability teams, and auditors preparing mandatory AASB S2 disclosures for ASX-listed entities and large proprietary companies.

Multiply the state grid factor by total kWh consumed at each facility. For a Melbourne office consuming 120,000 kWh in 2025:

# Get VIC electricity factor
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?state=VIC&fuel_type=electricity&year=2025" \
  -H "Authorization: ApiKey YOUR_KEY"

# VIC factor: 0.78 kg CO2-e/kWh
# 120,000 kWh × 0.78 = 93,600 kg CO2-e = 93.6 tCO2-e Scope 2

Disclosure requirement: AASB S2 requires disclosure of the emission factors used and their source. Include publication_reference ("National Greenhouse Accounts Factors 2025") and data_lineage.attribution in your report appendix.

2. Scope 1 stationary combustion (natural gas, diesel)

Who uses this: Manufacturers, logistics operators, and mining companies calculating direct emissions from on-site fuel combustion.

# All stationary combustion factors — natural gas
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?fuel_type=natural+gas" \
  -H "Authorization: ApiKey YOUR_KEY"

# Diesel combustion
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?fuel_type=diesel" \
  -H "Authorization: ApiKey YOUR_KEY"

Note on units: Stationary combustion factors are expressed in kg CO2-e/GJ. Convert your energy consumption from litres or cubic metres to gigajoules using the energy content values in the same NGA workbook before applying the factor.

3. Multi-state facility portfolio reporting

Who uses this: Retailers, banks, and property groups with facilities across multiple states needing state-specific Scope 2 factors.

# Fetch all state electricity factors in one call
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors?fuel_type=electricity&year=2025&limit=20" \
  -H "Authorization: ApiKey YOUR_KEY"

The response returns one row per state. Apply the matching state factor to each facility's kWh consumption, then sum for the portfolio total. SA (0.22) and TAS (0.20) have the lowest grid factors due to high renewable penetration; VIC (0.78) is the highest.

4. Workbook version audit trail for disclosures

Who uses this: Auditors and sustainability assurance providers verifying that the correct workbook year was used in a disclosure.

# Confirm which workbook is loaded before generating report
curl "https://api.techcompass.com.au/v1/au/climate/nga-factors/versions" \
  -H "Authorization: ApiKey YOUR_KEY"

Audit trail: Every response embeds data_lineage.source (e.g. "DCCEEW National Greenhouse Accounts Factors 2025"), workbook_version, and request_id. Store the request_id alongside your emissions calculation — Tech Compass maintains an immutable audit log of every API call tied to this ID.

About this API

What this API does

The Tech Compass AU Climate Disclosure API provides machine-readable access to the DCCEEW National Greenhouse Accounts (NGA) Factors workbook — the Australian Government's authoritative emission factors for calculating greenhouse gas emissions. It returns state-level electricity grid factors, stationary combustion factors, and transport factors in structured JSON with full data lineage, enabling automated Scope 1, 2, and 3 emissions calculations for AASB S2 and NGER reporting.

Who uses this API

ASX-listed entities and large proprietary companies preparing mandatory AASB S2 climate disclosures
Sustainability teams automating annual greenhouse gas inventories
ESG software platforms embedding Australian-specific emission factors into calculation engines
Auditors and assurance providers verifying emission factor sources for disclosure sign-off
Banks and insurers assessing physical and transition climate risk in their loan and insurance books
Property and facilities managers calculating portfolio-level Scope 2 emissions by state

Applicable compliance frameworks

AASB S2 Climate-related Disclosures — mandatory Group 1 from 1 Jan 2025, Group 2 from 1 Jul 2026
ISSB IFRS S2 — international climate disclosure standard aligned with TCFD
National Greenhouse and Energy Reporting Act 2007 (NGER Act) — mandatory reporting threshold entities
TCFD (Task Force on Climate-related Financial Disclosures) — Scope 1/2/3 emissions disclosure
GHG Protocol Corporate Accounting and Reporting Standard — location-based Scope 2 method
APRA CPG 229 — climate risk guidance for ADIs, insurers, and superannuation funds

Data source

Department of Climate Change, Energy, the Environment and Water (DCCEEW) — National Greenhouse Accounts Factors — CC BY 4.0 Commonwealth of Australia

Frequently asked questions

Which workbook year is currently loaded?: Call GET /v1/au/climate/nga-factors/versions to see the current workbook version and publication reference. The 2025 workbook is live as of launch. DCCEEW typically publishes the updated workbook in January or February each year.
What is the correct factor for an ACT facility?: The ACT draws from the NSW grid. Use the NSW factor (0.64 kg CO2-e/kWh for 2025). Querying state=ACT automatically returns the NSW factor with a disclosure note explaining the grid relationship — no manual lookup needed.
Does this API cover Scope 3 emissions?: The NGA workbook covers Scope 1 (stationary combustion, transport fuels) and Scope 2 (purchased electricity). Scope 3 requires product life-cycle data not published by DCCEEW. The Tech Compass API mirrors the NGA workbook scope — Scope 3 factors are outside the current dataset.
Can I use these factors for NGER reporting?: Yes. The NGA Factors workbook is the mandated source for NGER calculations. The factors returned by this API are identical to those in the current workbook. Include publication_reference and workbook_version from the response in your NGER report for traceability.
How do I handle historical reporting periods?: DCCEEW updates factors annually. If you need a prior year's factors, call /nga-factors?year=YYYY once those workbooks have been ingested. The /versions endpoint shows which years are available. Each year's factors remain in the database permanently and are not overwritten when a new workbook is ingested.

Related APIs

AU Entity Intelligence API — ASIC and ABR company status for climate risk counterparty screening
Compliance Monitoring API (CMaaS) — automated alerts when monitored entities trigger compliance events
Multi-Jurisdiction Sanctions API — screen counterparties before entering climate-linked finance deals