healthbR (version 0.2.0)

ans_operators: Download ANS Operators Registry

Description

Downloads and returns the current registry of health plan operators from the ANS open data portal. This is a snapshot of the current operator status (not time-series data).

Usage

ans_operators(status = "active", vars = NULL, cache = TRUE, cache_dir = NULL)

Value

A tibble with operator data. When status = "all", includes a status column indicating "active" or "cancelled".

Arguments

status

Character. Filter by operator status:

• "active": Active operators only (default).

• "cancelled": Cancelled operators only.

• "all": Both active and cancelled.

vars

Character vector. Variables to keep. If NULL (default), returns all 20 variables. Use ans_variables(type = "operators") to see available variables.

cache

Logical. If TRUE (default), caches downloaded data.

cache_dir

Character. Directory for caching.

See Also

Other ans: ans_cache_status(), ans_clear_cache(), ans_data(), ans_info(), ans_variables(), ans_years()

Examples

if (FALSE) { # interactive()
# active operators
ops <- ans_operators()

# all operators (active + cancelled)
all_ops <- ans_operators(status = "all")
}