> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macrobymark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Release notes and API changes for Macro by Mark.

# Changelog

All notable API changes are documented here. Macro by Mark follows
[Semantic Versioning](https://semver.org/) for breaking changes.

<Note>
  Subscribe to the [changelog RSS feed](https://macrobymark.com/changelog/rss)
  or watch this page to be notified of new releases.
</Note>

***

## v1.0.0 — 2025-05-01

**Initial public release** 🎉

### Endpoints

* `GET /indicators/search` — Full-text search across all available indicators.
* `GET /indicators/series` — Retrieve series records by indicator ID.
* `GET /indicators/observations` — Time-series observations with date-range
  filtering, unit transformations, and vintage selection.
* `GET /indicators/metadata` — Detailed indicator metadata including source
  attribution and methodology notes.
* `GET /indicators/releases` — Upcoming and historical data release schedules.
* `GET /indicators/vintages` — Available vintage dates for point-in-time
  backtesting.

### Providers at launch

`FRED`, `BLS`, `BEA`, `WORLDBANK`, `OECD`, `IMF`, `EUROSTAT`, `ECB`

### Authentication

API key authentication via `X-API-Key` header. Three plans available:
Free, Starter, and Pro.

***

*Older entries will appear here as the API evolves.*