Export Bundle

Returns a reproducibility package for one curated indicator. The server endpoint returns JSON; the in-app export action can wrap the same manifest, CSV, and chart image into a client-side ZIP.

Requires a signed-in Research or Pro account while paywalls are enabled. The same source-rights checks still run after plan access is verified.

Endpoint

GET /api/indicators/{slug}/export-bundle

Requires a signed-in Research or Pro account while paywalls are enabled. The source-rights compliance check still runs after plan access is verified.

Query Parameters

Response

format=bundle returns:

{
  "schema": "macrobymark/export-bundle/v1",
  "generatedAt": "2026-05-04T00:00:00.000Z",
  "indicator": {
    "slug": "real-gdp",
    "source": "bea",
    "sourceId": "A191RL",
    "unit": "Percent",
    "frequency": "quarterly",
    "dataStatus": "live",
    "revisionPolicy": "..."
  },
  "provider": {
    "key": "bea",
    "supportsVintages": true,
    "supportsRevisions": true,
    "observationHistory": {
      "kind": "estimate_round_tags",
      "historyKind": "provider_revision_tag",
      "historyLabel": "Provider revision tag",
      "label": "BEA estimate rounds",
      "hasTrueVintages": false,
      "disclaimer": "..."
    }
  },
  "compliance": {},
  "observations": {
    "count": 320,
    "dateRange": { "start": "1947-01-01", "end": "2026-03-31" },
    "data": []
  },
  "release": {},
  "guardrails": [],
  "citations": {
    "apa": "...",
    "bibtex": "...",
    "inline": "...",
    "manifest": {}
  },
  "economistGrade": {
    "overallScore": 84,
    "methodologyFacts": [],
    "qualityRubric": [],
    "comparabilityWarnings": [],
    "recommendedBasket": {},
    "economistNotes": [],
    "standardsAlignment": []
  },
  "relatedIndicators": []
}

Compliance Behavior

Exports are evaluated against the provider and dataset compliance registry. If a provider is blocked for export, the endpoint returns:

{
  "schema": "macrobymark/export-denied/v1",
  "error": "Export bundle blocked by source-rights policy.",
  "compliance": {}
}

The HTTP status comes from the compliance decision, usually 403.

Notes

• The JSON bundle is the canonical server artifact.
• Provider vintage and revision capability fields are disclosures. The observationHistory.historyLabel value is the user-facing evidence tier: Source-native vintage, Provider revision tag, Platform snapshot, or Current only.
• The in-app reproducibility manifest includes an economistGrade block with the same methodology drawer fields, quality rubric, comparability warnings, recommended concept basket, economist notes, and standards-alignment links shown on the indicator detail page.
• Client-side ZIP exports include manifest.json, data.csv, and chart.png when chart rendering is available in the browser.