Skip to content

Reference

Dataset IDs

All datasets use a four-segment dot-separated identifier.

Format

{country_iso2}.{institution_slug}.{topic}.{frequency}
SegmentTypeExampleNotes
country_iso2ISO 3166-1 alpha-2rwLowercase. Always present.
institution_slugLowercase slugnisr, bnrNo spaces or special characters.
topicTopic slugcpi, fx, budget-executionHyphens allowed.
frequencyFrequency slugmonthly, daily, annualSee valid values below.

Examples

A few real IDs, to show the shape:

IDInstitutionTopicFrequency
rw.nisr.cpi.monthlyNISRConsumer Price IndexMonthly
rw.bnr.fx.dailyBNROfficial exchange ratesDaily
rw.minecofin.budget-execution.quarterlyMINECOFINBudget executionQuarterly
rw.rssb.contributions.annualRSSBSocial security contributionsAnnual

For the full list, browse the imibare catalog or call imi.catalog().

Valid country codes

ISO 3166-1 alpha-2. Lowercase in IDs.

CodeCountry
rwRwanda
keKenya (future)
ugUganda (future)
tzTanzania (future)
biBurundi (future)

Valid institution slugs (Rwanda)

SlugInstitution
nisrNational Institute of Statistics of Rwanda
bnrNational Bank of Rwanda
minecofinMinistry of Finance and Economic Planning
rssbRwanda Social Security Board
rraRwanda Revenue Authority

Valid topic slugs

SlugMeaning
macroeconomicsGDP, national accounts
pricesCPI, PPI, inflation
labourEmployment, wages, labour force
budgetGovernment budget, expenditure
tradeImports, exports, balance of trade
demographicsPopulation, migration, tourism
social-securityContributions, pensions, insurance
monetaryExchange rates, interest rates, money supply
taxRevenue by tax type

Valid frequency slugs

SlugCadence
dailyEach trading or calendar day
monthlyEach calendar month
quarterlyEach fiscal or calendar quarter
annualEach calendar or fiscal year

Permanence rules

Dataset IDs are permanent and immutable after publication.

  • An ID may never be changed.
  • A breaking schema change (incompatible column rename, type change) requires a new ID with a version suffix: rw.nisr.cpi.monthly.v2.
  • A dataset may be deprecated (set to pipeline: stale) but its ID is never removed from the catalog.
  • IDs always carry the country prefix. nisr.cpi.monthly is invalid; rw.nisr.cpi.monthly is correct.

Converting IDs to other formats

Dagster asset key: replace dots with underscores.

rw.nisr.cpi.monthly -> rw_nisr_cpi_monthly

DuckDB table name (Iceberg catalog): replace dots and hyphens with underscores.

rw.minecofin.budget-execution.quarterly -> rw_minecofin_budget_execution_quarterly

R2 storage path: replace dots with /.

rw.nisr.cpi.monthly -> v1/rw/nisr/cpi/monthly/latest.parquet