Economic Indicators

Metric History

GET/v2/metrics/{metric_code}/history

Returns the full time-series history for a specific macroeconomic metric and country. Supports cursor-based pagination for large result sets.

Included in: Growth.

Authentication

Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key · Authentication guide

Parameters

Name	In	Type	Required	Description
metric_code	path	string	yes	Metric code to retrieve history for. See EconomyMetricCode schema for all 63 available codes (e.g. CPI, GDP_REAL, UNEMPLOYMENT_RATE). One of `BUSINESS_CONFIDENCE_EU` `EXPORT_ORDERS` `IFO_BUSINESS_CLIMATE` `IFO_EXPECTATIONS` `CONSUMER_CONFIDENCE_US` `GFK_CONSUMER` `UMICH_SENTIMENT` `CONSUMER_EXPENDITURE` `HOUSEHOLD_CONSUMPTION_WB` `PCE` `RETAIL_SALES` `ZEW_SENTIMENT` `CRUDE_OIL_IMPORTS` `CRUDE_OIL_STOCKS` `DISTILLATE_PRODUCTION` `DISTILLATE_STOCKS` `GASOLINE_STOCKS` `REFINERY_CRUDE_RUNS` `REFINERY_UTILIZATION` `EMPLOYED_PERSONS` `INITIAL_CLAIMS` `JOB_OPENINGS` `LABOR_FORCE_PARTICIPATION` `LABOR_FORCE_WB` `NONFARM_PAYROLLS` `UNEMPLOYMENT_ILO` `UNEMPLOYMENT_RATE` `UNEMPLOYMENT_WB` `GDP_GROWTH_WB` `GDP_NOMINAL` `GDP_NOMINAL_WB` `GDP_PER_CAPITA_WB` `GDP_REAL` `GDP_REAL_WB` `GOVT_CONSUMPTION` `BUILDING_PERMITS` `CONSTRUCTION_PRICE_INDEX` `HOME_PRICE_INDEX` `HOUSE_PRICE_INDEX` `HOUSING_STARTS` `NEW_HOME_SALES` `AVG_HOURLY_EARNINGS` `INCOME_STATISTICS` `PERSONAL_INCOME` `INDUSTRIAL_PRODUCTION` `MANUFACTURING_IP` `CPI` `CPI_WB` `CPI_CORE` `GDP_DEFLATOR` `HICP` `HICP_CORE` `HICP_CORE_INDEX` `HICP_INDEX` `INFLATION_WB` `PCE_PRICE_INDEX` `PPI` `PPI_FINAL_DEMAND` `BOC_RATE` `BOE_RATE` `BOJ_RATE` `BOK_RATE` `DE_10Y_YIELD` `DE_3M_RATE` `ECB_DFR` `ECB_MRR` `FED_FUNDS` `PBOC_RATE` `POLICY_RATE` `RBA_RATE` `BUSINESS_INVESTMENT` `GROSS_CAPITAL_FORMATION_WB` `PRIVATE_INVESTMENT` `DURABLE_GOODS_ORDERS` `M2_PCT_GDP_WB` `MONEY_SUPPLY_M1` `MONEY_SUPPLY_M2` `MONEY_SUPPLY_M3` `EXPORTS_GOODS_SERVICES` `IMPORTS_GOODS_SERVICES` `TRADE_BALANCE` `WHOLESALE_TRADE` Example `CPI`
country	query	string	yes	ISO 3166-1 alpha-2 country code (e.g. US, DE, JP) Example `US`
from	query	string (date)	no	Start date for the time series (YYYY-MM-DD)
to	query	string (date)	no	End date for the time series (YYYY-MM-DD)
source	query	string	no	Filter by data source code (e.g. BLS, FRED, EUROSTAT) Example when explicitly filtering: `BLS`.
vintage	query	string	no	Vintage date for revision tracking. Returns the data as it was known on this date. Example when explicitly filtering: `2026-01-15`.
cursor	query	string	no	Pagination cursor (reference_period value from previous response's next_cursor). Use instead of from for subsequent pages.
limit	query	integer (int32)	no	Maximum number of observations to return per page (default 1000, max 1000) Default `1000`

Try it

metric_code required path

Metric code to retrieve history for. See EconomyMetricCode schema for all 63 available codes (e.g. CPI, GDP_REAL, UNEMPLOYMENT_RATE).

country required query

ISO 3166-1 alpha-2 country code (e.g. US, DE, JP)

GET /v2/metrics/CPI/history?country=US

API key

Sent only to api.bavest.co for this request; not stored.

Sign in to send Get an API keySends with the key above, or sign in to use your account's key. Each request counts as one API call.

curl 'https://api.bavest.co/v2/metrics/CPI/history?country=US' \
  -H "x-api-key: $BAVEST_API_KEY"

Samples read your key from BAVEST_API_KEY and follow the form.

Example response 200

{
  "data": {
    "category": "inflation",
    "country": "US",
    "from": "1947-01-01",
    "to": "2026-08-01",
    "next_cursor": null,
    "metrics": [
      {
        "code": "CPI",
        "name": "CPI All Urban Consumers",
        "frequency": "Monthly",
        "unit": "INDEX_1982",
        "count": 956,
        "data": [
          {
            "reference_period": "2026-07-01",
            "period_end": null,
            "value": 333.918,
            "is_revised": false
          },
          {
            "reference_period": "2026-08-01",
            "period_end": null,
            "value": 334.98,
            "is_revised": false
          }
        ]
      },
      {
        "code": "CPI",
        "name": "CPI All Urban Consumers",
        "frequency": "Monthly",
        "unit": "INDEX_2015",
        "count": 841,
        "data": [
          {
            "reference_period": "2026-01-01",
            "period_end": null,
            "value": 2.3864,
            "is_revised": false
          },
          {
            "reference_period": "2026-02-01",
            "period_end": null,
            "value": 2.4141,
            "is_revised": false
          }
        ]
      }
    ]
  },
  "meta": {
    "parameters": {
      "metric_code": "CPI",
      "country": "US",
      "limit": "1000"
    },
    "time": 2022
  }
}

From the docs, not your data. Long lists are cut to 3 items.

Response 200

Successful response · application/json

dataMetricsHistoryResponse
Full time-series history for a macroeconomic metric in a single country.
- categorystring | null
  Metric category (e.g. inflation, gdp, employment)
  Example inflation
- countrystring
  ISO 3166-1 alpha-2 country code
  Example US
- fromstring (date) | null
  Earliest reference period in the returned data
  Example 2020-01-01
- tostring (date) | null
  Latest reference period in the returned data
  Example 2026-02-01
- next_cursorstring | null
  Cursor for the next page of results. Pass as the cursor query parameter to fetch the next page. Null when there are no more pages.
  Example 2020-01-01
- metricsarray of MetricsHistoryMetric
  Metric time-series data (always a single-element array for the requested metric)
metaResponseMeta
Response envelope metadata. Always present on a 200: time is set by core/response.py on every successful response. Errors carry the same block, built by the same code, so a client parses one meta shape whether the call succeeded or failed.
- timeinteger
  Server-side processing time in milliseconds
  Example 17
- parametersobject
  Echo of the request parameters the endpoint resolved

Errors

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
401Missing or invalid API key.
404Resource not found.
429Rate limit exceeded. Retry after the `Retry-After` header interval.
500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.