Back to documentation

API

A stable interface for data and metadata.

Current public endpoints use fixture data and require no authentication. Production will add keys, quotas, and versioning without changing the core structure.

MethodEndpointPurpose
GET/api/catalog?q=reserves&source=BCBSearch the catalog
GET/api/series/reservesRetrieve metadata
GET/api/series/reserves/observations?from=2024-01-01Retrieve observations
GET/api/series/reserves/vintagesList vintages
GET/api/sourcesList sources
GET/api/coverageInspect coverage
GET/api/calendar?source=BCB&status=expectedInspect the release calendar
curl
curl "https://boliviadb.com/api/series/reserves/observations?from=2024-01-01"
JSON response
{
  "data": [
    {
      "seriesId": "reserves",
      "period": "2026-06-01",
      "value": 3310,
      "status": "provisional",
      "vintageDate": "2026-07-10"
    }
  ],
  "meta": { "fixture": true, "count": 1 }
}

Conventions

Dates

ISO 8601 (YYYY-MM-DD)

Missing values

null

Frequencies

daily, weekly, monthly, quarterly, annual

Errors

JSON with error code and HTTP status