# Macro

> Two official U.S. series from the Bureau of Labor Statistics, CPI and unemployment, latest readings only.

```text
GET /v1/macro/{series}
```

One official macro series as a single document. We include a series only when its source's own terms clearly allow resale. Today that's two series from the U.S. Bureau of Labor Statistics.

```bash
curl -H "X-API-Key: $BELFORT_API_KEY" \
  https://belfort-data-api.vercel.app/v1/macro/cpi_u_all_items_sa
```

| `series` | BLS series | What it is |
|---|---|---|
| `cpi_u_all_items_sa` | `CUSR0000SA0` | Consumer Price Index for All Urban Consumers, all items, seasonally adjusted |
| `unemployment_rate_sa` | `LNS14000000` | Unemployment rate, seasonally adjusted |

Any other series name gets a 404. The route takes no query parameters.

## The document

| Field | Meaning |
|---|---|
| `series`, `series_id` | Our name for the series, and the BLS series ID. |
| `title`, `unit` | What it measures, and in what unit. |
| `seasonal_adjustment`, `revision_status` | Whether it's seasonally adjusted, and its revision status. |
| `keep_vintages` | `false`: see below. |
| `source_url`, `fetched_at` | Where we read it, and when. |
| `points` | The readings: each with `date`, `value`, `unit`, `source_url`, `fetched_at`, `seasonal_adjustment` and `revision_status`. |

## What to expect

- **Latest readings only.** CPI and unemployment are revised after they're first published. We keep the latest published reading for each date, not the earlier versions.
- **Cite the source.** BLS data is in the public domain, and BLS asks that you cite the Bureau of Labor Statistics as the source.
- **Other series are left out on purpose.** We read the U.S. Treasury's daily yield curve and the New York Fed's effective federal funds rate, but their terms don't clearly allow resale, so they aren't served.

---
Source: https://docs.belfortagent.xyz/datasets/macro/