Skip to main content

Public Reporting

The Public Reporting domain models the content, structure and approval of formal public reports, and the specific disclosures a requirement calls for. It gives a traceable record of what was disclosed, when, and under whose authority.

  • Public report: a report the organization makes public, such as an annual report, a valuation, a privacy policy or a market announcement.
  • Mandatory disclosure: a specific piece of information that an obligation or compliance requirement calls for the organization to publish, such as the kinds of decisions it makes by automated means.

Schemas: public-report.schema.json, mandatory-disclosure.schema.json
Specification: JSON Schema Draft-07

Each disclosure must name at least one obligation or compliance requirement behind it, so a disclosure is never orphaned from its source. AI disclosures can also name the standardised use cases whose operation they describe.

Public Report​

AttributeTypeDescriptionRequired
publicReportIDStringUnique identifier for the report, e.g. PR-VAL-001✓
titleStringShort, descriptive name of the report✓
descriptionStringWhat the report covers
reportTypeEnumFormal type of the report: financial, technical, valuation, compliance, sustainability, governance, privacyPolicy, marketAnnouncement, productDisclosure, aiDisclosure, other✓
reportStatusEnumLifecycle status of the report: draft, approved, published, cancelled, withdrawn✓
versionStringVersion of the report, e.g. 1.0✓
issuingStakeholderTitleStringPerson or team responsible for issuing the report
issuingStakeholderIDStringStakeholder record for the issuer
orgUnitIDStringOrganization unit that owns the report
reportingPeriodObjectPeriod the report covers
reportingPeriod.startDateDateStart date (required)
reportingPeriod.endDateDateEnd date (required)
publishedDateDateDate the report was made public
linkToDocumentStringLink to the published document
lodgedWithExternalOrgIDStringRegulator, exchange or registry the report was lodged with, if any
mandatoryDisclosureIDsArray[String]Mandatory disclosures the report contains
statementOfComplianceIDsArray[String]Statements of compliance published in the report

Report Type (reportType)​

ValueDescription
financialPrimarily financial data, e.g. profit and loss, balance sheet
technicalTechnical assessments, e.g. geological or engineering
valuationValuation of an asset or company
complianceA direct statement of compliance
sustainabilitySustainability or climate reporting
governanceCorporate governance statement
privacyPolicyPrivacy policy, including any automated decision disclosures
marketAnnouncementAnnouncement to a securities exchange
productDisclosureProduct disclosure document
aiDisclosureA report or section whose purpose is to disclose the use of AI or automated decision-making
otherAnother kind of report

Report Status (reportStatus)​

ValueDescription
draftIn preparation; not approved
approvedFormally approved internally
publishedMade public
cancelledPublication formally stopped
withdrawnRemoved after publication
{
"publicReportID": "PR-VAL-001",
"title": "Technical Assessment & Valuation Report",
"description": "A valuation of the company's mineral assets as of Q3 2025.",
"reportType": "valuation",
"reportStatus": "published",
"version": "1.0",
"issuingStakeholderTitle": "Anna L.",
"issuingStakeholderID": "STK-ANNA-L",
"linkToDocument": "https://cdn.example.com/reports/PR-VAL-001.pdf",
"mandatoryDisclosureIDs": [
"DISC-001",
"DISC-002"
]
}

Mandatory Disclosure​

AttributeTypeDescriptionRequired
mandatoryDisclosureIDStringUnique identifier for the disclosure, e.g. DISC-001✓
titleStringShort name of the disclosure✓
descriptionStringWhat must be disclosed, in source-describing language
disclosureChannelEnumWhere the disclosure is made: annualReport, privacyPolicy, website, marketAnnouncement, regulatorLodgement, productDisclosure, pointOfInteraction, other
obligationIDsArray[String]Obligations (semantic library) that call for the disclosure
complianceRequirementIDsArray[String]Compliance requirements that call for the disclosure
sourceDataArray[Object]Records the disclosed information is drawn from
sourceData[].domainTypeEnumDomain of the referenced entity, from the shared domain list (domainType in common.schema.json) (required)
sourceData[].entityIDStringUnique identifier of a record within its domain, for example "CAP-001" or "MKT-ENTSW-001" (required)
sourceData[].titleStringName of the referenced entity, for readability
useCaseIDsArray[String]Standardised AI use cases whose operation the disclosure describes, for AI disclosures
stakeholderTitleStringPerson or role accountable for the disclosure
stakeholderIDStringStakeholder record for that person or role
publicReportIDsArray[String]Public reports that contain the disclosure
frequencyEnumHow often the disclosure is made or refreshed: continuous, realTime, hourly, daily, weekly, monthly, quarterly, semiAnnually, annually, eventDriven, onDemand, adHoc

Disclosure Channel (disclosureChannel)​

ValueDescription
annualReportAnnual or periodic report
privacyPolicyPrivacy policy
websiteWebsite page
marketAnnouncementExchange announcement
regulatorLodgementLodged with a regulator
productDisclosureProduct disclosure document
pointOfInteractionAt the point a person interacts with the system, e.g. an AI notice in a chat
otherAnother channel
{
"mandatoryDisclosureID": "DISC-001",
"title": "Competent Person statement",
"sourceData": [
{
"domainType": "information",
"entityID": "INFO-RESOURCE-MODEL"
}
],
"complianceRequirementIDs": [
"CREQ-VALMIN-3.1"
],
"stakeholderID": "STK-ANNA-L",
"disclosureChannel": "marketAnnouncement"
}