Fetches the best available observation-history evidence for a series. The response distinguishes source-native historical vintages from provider revision tags and Macro-captured platform snapshots.
Endpoint
GET /api/indicators/{slug}/revisions
Query Parameters
| Name | Type | Default | Description |
|---|---|---|---|
vintageDate | YYYY-MM-DD | today | Point-in-time vintage date requested from the provider. |
Supported Providers
| Provider | Support |
|---|---|
| FRED | Source-native vintages via FRED/ALFRED realtime dates. |
| BLS | Provider revision tags from observation footnotes. |
| BEA | Provider estimate-round tags using BEA table parameters where available. |
| IMF, ECB, FAOSTAT, OECD, Eurostat, BIS, World Bank, and selected official-source providers | Platform snapshots captured by Macro by Mark after successful live observation fetches. |
Current-only providers return 400 with historyLabel: "Current only".
Response
{
"provider": "fred",
"seriesId": "GDP",
"vintageDate": "2026-05-04",
"observations": [],
"fetchedAt": "2026-05-04T00:00:00.000Z",
"capabilityKind": "alfred_vintage",
"capabilityLabel": "ALFRED vintages",
"capabilityDisclaimer": "...",
"historyKind": "source_native_vintage",
"historyLabel": "Source-native vintage"
}
Disclosure
The historyLabel field is the user-facing evidence tier:
Source-native vintage, Provider revision tag, Platform snapshot, or
Current only. Platform snapshots are captured-forward records from Macro by
Mark and do not reconstruct provider states before snapshot capture began.