Data dictionary & object map

Purpose of each lifecycle domain object and how records connect (read-only reference)
Demo storylines Lifecycle trace

Terminology aligns with Phase 5: carbon credits / offset credits are issued against verified mitigation; custody uses carbon accounts & credit holdings; lifecycle trace charts graph edges across these records. Legacy instruments lots remain for compatibility only.

Organization

Primary resource · organizations

Purpose: Legal entity enrolling in the programme — developer, verifier, airline, regulator, marketplace participant.

Key fields: id, name, jurisdiction, onboarding / KYC status.

Links: Facilities & carbon accounts by ownerOrganizationId; claims & retirement requests cite org names.

Lifecycle role: Primary party dimension for permissions (demo personas) & ownership.

Facility

Primary resource · facilities

Purpose: Physical or logical site emitting or hosting mitigation equipment.

Links: Emission inventories, project facility metadata.

Emission inventory

Primary resource · emissionInventories

Purpose: Reporting lines (scope × activity × emission factor → tCO₂e).

Knowledge tie-in: Emission-factor guidance surfaces on the emissions inventory workspace.

Lifecycle role: Footprint counterpart to mitigation & offset claims.

Carbon project

Primary resource · projects

Purpose: Registered mitigation initiative (renewable energy, methane, forestry …).

Key fields: Methodology hints, geography, registry ref, demo externalProjectId + integration readiness.

Links: Monitoring reports, verification cases, issuance rows, batches.

Monitoring report

Primary resource · monitoringReports

Purpose: Period GHG/removal quantitative claim + monitoring narrative.

Links: Verification case via linkedVerificationCaseId; project via projectId.

Verification case (MRV)

Primary resource · verificationCases

Purpose: Bounded review window for validating monitoring / issuance assertions.

Interop: externalVerifierRef, integrationReadiness placeholders.

Links: Findings, issuance request, lifecycle trace panel.

Verification finding

Primary resource · verificationFindings

Purpose: Record non-conformance, corrective action expectations, disposition.

Lifecycle role: Gates approval & conditions issuance quality.

Issuance request

Primary resource · issuanceRequests

Purpose: Ask registry-style issuance of offset credits from verified mitigation.

Interop: Registry reference numbers, external project linkage, adapter readiness fields.

Links: Creates / references credit batch, target holdings.

Credit batch

Primary resource · creditBatches

Purpose: Homogenous pool of fungible tonnes (vintage, methodology, registry identity).

Lifecycle role: Bridge between issuance and tradable holdings / retirements.

Carbon account

Primary resource · carbonAccounts

Purpose: Registry-style wallet identifiers per organization.

Lifecycle role: Parent entity for holdings & retirement debits.

Credit holding

Primary resource · creditHoldings

Purpose: Custody ledger rows for available / retired tonnes by batch.

Links: Trades debit/credit holdings; retirement consumes available tonnes.

Marketplace listing

Primary resource · marketplaceListings

Purpose: Offer liquidity for tonnes at a quoted price · maps to batches & seller custody.

Trade order

Primary resource · tradeOrders

Purpose: OTC / bilateral / marketplace bilateral purchase contracting.

Settlement: Wallet flow updates holdings (primary path) or legacy lot mint stub.

Retirement

Primary resource · retirementRequests

Purpose: Intent to permanently remove offset credits for a beneficiary / storyline.

Produces: Retirement certificate record when lifecycle API completes retirement.

Retirement certificate

Primary resource · retirementCertificates

Purpose: Immutable-style proof row for tonnes retired · serial / registry references.

Lifecycle role: Feeds sustainability claims & public proof lookups.

Offset attribution

Primary resource · offsetAttributions

Purpose: Operational link between passenger / freight / SKU activity estimates and retired tonnes.

Sustainability claim

Primary resource · sustainabilityClaims

Purpose: Publishable statement referencing retirements · may expose public proof slug.

Risk exception

Primary resource · carbonExceptions

Purpose: Integrity disputes, suspected double counting, evidence gaps · cross-links to ledger objects.

Knowledge item

Primary resource · knowledgeItems

Purpose: Operationalized playbook layer — methodologies, EF digests, registry rules, verifier guidance filtered by lifecycle area.

Explore: Knowledge repository