Retrieve incremental entity updates

Query the brreg change data capture (CDC) endpoint for entities modified since a given date. Each update carries a monotonically increasing update_id suitable for cursor-based pagination and deduplication.

Usage

brreg_updates(
  since = Sys.Date() - 1,
  size = 100,
  max_pages = 1L,
  include_changes = FALSE,
  type = c("enheter", "underenheter", "roller"),
  verbose = FALSE
)

Arguments

since

Date or POSIXct. Return updates after this timestamp. Defaults to yesterday.

size

Integer. Number of updates per page (max 10000).

max_pages

Integer. Maximum pages to fetch. Default 1. Set higher to paginate through large result sets automatically.

include_changes

Logical. If TRUE, include field-level change details per update as a list-column of tibbles.

type

One of "enheter", "underenheter", or "roller". Roller uses CloudEvents format; include_changes is ignored.

verbose

Logical. Print page-level progress.

Value

A tibble with columns: update_id, org_nr, change_type, timestamp. If include_changes = TRUE, a list-column changes with tibbles of operation, field, new_value.

See also

brreg_update_fields() for a flat alternative.

Other tidybrreg entity functions: brreg_board_summary(), brreg_children(), brreg_download(), brreg_entity(), brreg_roles(), brreg_roles_legal(), brreg_search(), brreg_underenheter(), brreg_update_fields()

Examples

if (FALSE) { # interactive() && curl::has_internet()
brreg_updates(since = Sys.Date() - 1, size = 10)

# Auto-paginate
brreg_updates(since = "2026-03-01", size = 10000, max_pages = 50,
              verbose = TRUE)
}