Examples

Downloadable examples for the canonical v2 filing model and the older legacy v1 shape.

The examples in this repo now fall into two categories:

Canonical v2 The fact-centric model used for new import, validation, export, and package work.
Legacy v1 The earlier statement-shaped model kept for compatibility.

If you are starting new work, use the canonical v2 example first.

Canonical v2 Example

This is the recommended starting point for new integrations.

{
  "document": {
    "version": "2.0.0",
    "documentType": "filing",
    "profile": "sec-us-gaap-annual",
    "jurisdiction": "US-SEC",
    "sourceFormat": "sfrs-json",
    "createdAt": "2026-03-10T00:00:00Z"
  },
  "entity": {
    "name": "Acme Corporation",
    "jurisdiction": "US-DE",
    "identifiers": [
      { "scheme": "cik", "value": "0001234567" }
    ]
  },
  "taxonomyRefs": [
    { "name": "us-gaap", "version": "2025" }
  ],
  "contexts": [
    {
      "id": "c_duration_2024",
      "entityIdentifier": "0001234567",
      "period": {
        "startDate": "2024-01-01",
        "endDate": "2024-12-31"
      }
    }
  ],
  "units": [
    { "id": "u_usd", "measures": ["iso4217:USD"] }
  ],
  "facts": [
    {
      "id": "f_revenue",
      "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
      "contextRef": "c_duration_2024",
      "unitRef": "u_usd",
      "value": 25000000,
      "decimals": -3
    }
  ],
  "footnotes": [
    {
      "id": "fn_revenue",
      "factRefs": ["f_revenue"],
      "language": "en",
      "content": "Revenue reflects product and services contracts recognized during fiscal year 2024."
    }
  ]
}

Legacy v1 Example

This older model is still useful if you are maintaining a statement-shaped integration.

{
  "$sfrs": "1.0",
  "metadata": {
    "entityId": "0001234567",
    "entityName": "Acme Corporation",
    "taxonomy": "us-gaap-2024",
    "filingType": "10-K",
    "periodStart": "2024-01-01",
    "periodEnd": "2024-12-31",
    "currency": "USD"
  },
  "balanceSheet": {
    "asOfDate": "2024-12-31",
    "assets": { "totalAssets": 19600 },
    "liabilities": { "totalLiabilities": 11200 },
    "stockholdersEquity": { "totalStockholdersEquity": 8400 }
  },
  "incomeStatement": {
    "periodStart": "2024-01-01",
    "periodEnd": "2024-12-31",
    "revenue": 28500,
    "netIncome": 3400
  }
}

Download Examples

Downloadable files served directly from the docs app:

acme-corp-10k-2024.v2.json Canonical v2 filing example
sample-10k.sfrs.json Legacy v1 statement-shaped example

Examples

Canonical v2 Example

Legacy v1 Example

Download Examples

Related Guides

On this page