Author: tatooheene team
Date: 2025-12-15

# Reference prices: lookups by domain/category/unit & years (table vs single value)

#### tatooheene team

#### 2025-12-15

## What this vignette covers

- Where the reference prices live: tatooheene::df_ref_prices.

- How to use nl_ref_prices() to:

  - filter by domain, category, unit, short_unit

  - select one or multiple years (e.g., 2022 or c (2022, 2023) ),

  - choose currency (“EUR” or “INT$”; PPP adjusted), and

  - return either a table or a single numeric value (with a printed label).

> The function is . Column names reflect the CBS table embedded in `df_ref_prices`.

## The underlying data

    df_ref_prices %>%
      head()
    #>    Domain       Category
    #> 1 Medical        Nursing
    #> 2 Medical        Nursing
    #> 3 Medical        Nursing
    #> 4 Medical Day treatments
    #> 5 Medical Day treatments
    #> 6 Medical Day treatments
    #>                                                             Unit
    #> 1                Nursing day excluding personnel costs, hospital
    #> 2                Nursing day including personnel costs, hospital
    #> 3 Nursing day, intensive care (incl. diagnostics and medication)
    #> 4                                        Day treatment, hospital
    #> 5                           Intravenous administration, hospital
    #> 6                          Subcutaneous administration, hospital
    #>                   short_var    2022       2023       2024
    #> 1 nursingday_excl_personnel  537.00  557.40600  576.20100
    #> 2 nursingday_incl_personnel  644.00  668.47200  691.01200
    #> 3  nursingday_intensivecare 2727.00 2830.62600 2926.07100
    #> 4     daytreatment_hospital  335.00  347.73000  359.45500
    #> 5         iv_admin_hospital  171.00  177.49800  183.48300
    #> 6         sc_admin_hospital   75.28   78.14064   80.77544

## Quick starts

### 1) Default: all filters = “all” -> table of all reference prices over all years

    nl_ref_prices()
    #>                   Domain                        Category
    #> 1                Medical                         Nursing
    #> 2                Medical                         Nursing
    #> 3                Medical                         Nursing
    #> 4                Medical                  Day treatments
    #> 5                Medical                  Day treatments
    #> 6                Medical                  Day treatments
    #> 7                Medical               Outpatient visits
    #> 8                Medical                  Emergency care
    #> 9                Medical             Ambulance transport
    #> 10               Medical             Ambulance transport
    #> 11               Medical             Ambulance transport
    #> 12               Medical              Medical procedures
    #> 13               Medical              Medical procedures
    #> 14               Medical                     Diagnostics
    #> 15               Medical                     Diagnostics
    #> 16               Medical                     Diagnostics
    #> 17               Medical                     Diagnostics
    #> 18               Medical                     Diagnostics
    #> 19               Medical                     Diagnostics
    #> 20               Medical                     Diagnostics
    #> 21               Medical                     Diagnostics
    #> 22               Medical                     Diagnostics
    #> 23               Medical                     Diagnostics
    #> 24               Medical                     Diagnostics
    #> 25               Medical                     Diagnostics
    #> 26               Medical                     Diagnostics
    #> 27               Medical                     Diagnostics
    #> 28               Medical                     Diagnostics
    #> 29               Medical                     Diagnostics
    #> 30               Medical                     Diagnostics
    #> 31               Medical                     Diagnostics
    #> 32               Medical                     Diagnostics
    #> 33               Medical                     Diagnostics
    #> 34               Medical                     Diagnostics
    #> 35               Medical                     Diagnostics
    #> 36               Medical                     Diagnostics
    #> 37               Medical                     Diagnostics
    #> 38               Medical                     Diagnostics
    #> 39               Medical                     Diagnostics
    #> 40               Medical                     Diagnostics
    #> 41               Medical                     Diagnostics
    #> 42               Medical                     Diagnostics
    #> 43               Medical                     Diagnostics
    #> 44               Medical                     Diagnostics
    #> 45               Medical                     Diagnostics
    #> 46               Medical                     Diagnostics
    #> 47               Medical                     Diagnostics
    #> 48               Medical                    Medical aids
    #> 49               Medical                    Medical aids
    #> 50               Medical                    Medical aids
    #> 51               Medical                    Medical aids
    #> 52               Medical                    Medical aids
    #> 53               Medical                    Medical aids
    #> 54               Medical                    Medical aids
    #> 55               Medical                    Medical aids
    #> 56               Medical                    Medical aids
    #> 57               Medical                    Medical aids
    #> 58               Medical                GP consultations
    #> 59               Medical                GP consultations
    #> 60               Medical                GP consultations
    #> 61               Medical                GP consultations
    #> 62               Medical                GP consultations
    #> 63               Medical                GP consultations
    #> 64               Medical                Paramedical care
    #> 65               Medical                Paramedical care
    #> 66               Medical                Paramedical care
    #> 67               Medical                Paramedical care
    #> 68               Medical                Paramedical care
    #> 69               Medical                Paramedical care
    #> 70               Medical                Paramedical care
    #> 71               Medical                    Elderly care
    #> 72               Medical                    Elderly care
    #> 73               Medical                    Elderly care
    #> 74               Medical                    Elderly care
    #> 75               Medical                    Elderly care
    #> 76               Medical                    Elderly care
    #> 77               Medical                    Elderly care
    #> 78               Medical                       Home care
    #> 79               Medical                       Home care
    #> 80               Medical                       Home care
    #> 81               Medical                       Home care
    #> 82               Medical                       Home care
    #> 83               Medical                       Home care
    #> 84               Medical              Mental health care
    #> 85               Medical              Mental health care
    #> 86               Medical              Mental health care
    #> 87               Medical                       Home care
    #> 88               Medical                       Home care
    #> 89               Medical                       Home care
    #> 90               Medical              Mental health care
    #> 91               Medical              Mental health care
    #> 92               Medical              Mental health care
    #> 93               Medical              Mental health care
    #> 94               Medical              Mental health care
    #> 95               Medical              Mental health care
    #> 96               Medical              Mental health care
    #> 97               Medical              Mental health care
    #> 98               Medical              Mental health care
    #> 99               Medical              Mental health care
    #> 100              Medical             Rehabilitation care
    #> 101              Medical             Rehabilitation care
    #> 102              Medical             Rehabilitation care
    #> 103              Medical             Rehabilitation care
    #> 104              Medical             Rehabilitation care
    #> 105              Medical             Rehabilitation care
    #> 106              Medical                 Disability care
    #> 107              Medical                 Disability care
    #> 108              Medical                 Disability care
    #> 109              Medical                 Disability care
    #> 110              Medical                 Disability care
    #> 111              Medical                 Disability care
    #> 112              Medical                 Disability care
    #> 113              Medical                 Disability care
    #> 114              Medical                 Disability care
    #> 115              Medical                 Disability care
    #> 116              Medical                      Medication
    #> 117              Patient                  Transportation
    #> 118              Patient                  Transportation
    #> 119              Patient                  Transportation
    #> 120              Patient                  Transportation
    #> 121              Patient                  Transportation
    #> 122              Patient      Time costs for the patient
    #> 123 Productivity & Other   Productivity loss - Paid work
    #> 124 Productivity & Other Productivity loss - Unpaid work
    #> 125 Productivity & Other                       Education
    #> 126 Productivity & Other                       Education
    #> 127 Productivity & Other                       Education
    #> 128 Productivity & Other                       Education
    #> 129 Productivity & Other                       Education
    #> 130 Productivity & Other                       Education
    #> 131 Productivity & Other                       Education
    #> 132 Productivity & Other                       Education
    #> 133 Productivity & Other                       Education
    #> 134 Productivity & Other                       Education
    #> 135 Productivity & Other                       Education
    #> 136 Productivity & Other                       Education
    #> 137 Productivity & Other                       Education
    #> 138 Productivity & Other                       Education
    #> 139 Productivity & Other                       Education
    #> 140 Productivity & Other                       Education
    #> 141 Productivity & Other                       Education
    #> 142 Productivity & Other                       Education
    #> 143 Productivity & Other                       Education
    #> 144 Productivity & Other                       Education
    #> 145 Productivity & Other                       Education
    #> 146 Productivity & Other              Safety and Justice
    #> 147 Productivity & Other              Safety and Justice
    #> 148 Productivity & Other              Safety and Justice
    #> 149 Productivity & Other              Safety and Justice
    #> 150 Productivity & Other              Safety and Justice
    #> 151 Productivity & Other              Safety and Justice
    #> 152 Productivity & Other              Safety and Justice
    #> 153 Productivity & Other              Safety and Justice
    #> 154 Productivity & Other              Safety and Justice
    #> 155 Productivity & Other              Safety and Justice
    #> 156 Productivity & Other              Safety and Justice
    #> 157 Productivity & Other              Safety and Justice
    #> 158 Productivity & Other              Safety and Justice
    #> 159 Productivity & Other              Safety and Justice
    #> 160 Productivity & Other              Safety and Justice
    #>                                                                                                                                                                     Unit
    #> 1                                                                                                                        Nursing day excluding personnel costs, hospital
    #> 2                                                                                                                        Nursing day including personnel costs, hospital
    #> 3                                                                                                         Nursing day, intensive care (incl. diagnostics and medication)
    #> 4                                                                                                                                                Day treatment, hospital
    #> 5                                                                                                                                   Intravenous administration, hospital
    #> 6                                                                                                                                  Subcutaneous administration, hospital
    #> 7                                                                                                                                             Outpatient visit, hospital
    #> 8                                                                                                                                                         Emergency care
    #> 9                                                                                                                                       Ambulance ride, weighted average
    #> 10                                                                                                                                     Ambulance ride, ordered transport
    #> 11                                                                                                                                      Ambulance ride, urgent transport
    #> 12                                                                                                                         Conventional operating room, usage per minute
    #> 13                                                                                                                               Hybrid operating room, usage per minute
    #> 14                                                                                                                                        MRI general (weighted average)
    #> 15                                                                                                                                           MRI hips/ lower extremities
    #> 16                                                                                                                                                             MRI brain
    #> 17                                                                                                                                                 MRI lumbosacral spine
    #> 18                                                                                                                                    MRI shoulder(s)/ upper extremities
    #> 19                                                                                                                                                           MRI abdomen
    #> 20                                                                                                                                         CT general (weighted average)
    #> 21  CT examination of the abdomen, retroperitoneum, including included oral and/or rectal contrast agent, with or under administration of an intravenous contrast agent.
    #> 22                                                                              CT examination of the thorax, heart and major vessels including contrast agent injection
    #> 23                                                                                   CT examination of the brain and/or skull with or without intravenous contrast agent
    #> 24                                                                                   CT examination of the lower extremities, with or without intravenous contrast agent
    #> 25                                                                                        CT examination of the facial skull, with or without intravenous contrast agent
    #> 26                                                                                                                                      SPECT general (weighted average)
    #> 27                                                                                                                                              SPECT of skeleton detail
    #> 28                                                                                                      SPECT of heart chambers ECG-triggered, rest with EF calculations
    #> 29                                                                                                                                                    SPECT of the brain
    #> 30                                                                                                                                                      SPECT of abdomen
    #> 31                                                                                                                                        PET general (weighted average)
    #> 32                                                                                                                                         PET WB (Whole Body), oncology
    #> 33                                                                                                                             PET Partial (Neurological, Cardiological)
    #> 34                                                                                                                                 Ultrasound general (weighted average)
    #> 35                                                                                                                                        Ultrasound of abdominal organs
    #> 36                                                                                                                                          Ultrasound lower extremities
    #> 37                                                                                                                             Ultrasound a vue in relation to pregnancy
    #> 38                                                                                                                                              Ultrasound of the breast
    #> 39                                                                                                                                 Ultrasound of the thyroid and/or neck
    #> 40                                                                                                                                                     X-ray examination
    #> 41                                                                                                                                    24-hour blood pressure measurement
    #> 42                                                                                                                                                     CRP determination
    #> 43                                                                                                                                                   HbA1C determination
    #> 44                                                                                                                                                     TSH determination
    #> 45                                                                                                                                              Creatinine determination
    #> 46                                                                                                                                                  Creatinine clearance
    #> 47                                                                                                                                                    ALAT determination
    #> 48                                                                                                                                                        Arm prosthesis
    #> 49                                                                                                                                                        Leg prosthesis
    #> 50                                                                                Aids for the use of communication aids (e.g. computers for physically disabled people)
    #> 51                                                                               Aids for communication and information for visual impairments (e.g. magnifying glasses)
    #> 52                                                                                                               Other aids for communication, information and signaling
    #> 53                                                                                                                                                   Other mobility aids
    #> 54                                                                                                                                                   Other diabetes aids
    #> 55                                                                                                                               Other aids for arm-hand-finger function
    #> 56                                                                                                                                                   Orthopedic footwear
    #> 57                                                                                                                                                  Special optical aids
    #> 58                                                                    General practitioner, average consultation (also applicable for telephone and e-mail consultation)
    #> 59                                                    General practitioner, consultation shorter than 20 minutes (also applicable for telephone and e-mail consultation)
    #> 60                                                    General practitioner, consultation longer than 20 minutes (also applicable for telephone and e-mail consultation))
    #> 61                                                                                                                              General practitioner, average home visit
    #> 62                                                                                                              General practitioner, home visit shorter than 20 minutes
    #> 63                                                                                                               General practitioner, home visit longer than 20 minutes
    #> 64                                                                                                                                           Physiotherapy (per session)
    #> 65                                                                                                                                        Exercise therapy (per session)
    #> 66                                                                                                                                          Speech therapy (per session)
    #> 67                                                                                                                                    Occupational therapy (per session)
    #> 68                                                                                                                                             Diet advice (per session)
    #> 69                                                                                                                                Combined lifestyle interventions (GLI)
    #> 70                                                                                                                 Nursing & care, including daytime activities, per day
    #> 71                                                                                                                                      Daytime activities, per half day
    #> 72                                                                                                                        Geriatric rehabilitation care, average per day
    #> 73                                                                                                               Geriatric rehabilitation care after amputation, per day
    #> 74                                                                                                                   Geriatric rehabilitation care after stroke, per day
    #> 75                                                                                                         Geriatric rehabilitation care after elective surgery, per day
    #> 76                                                                                                                   Geriatric rehabilitation care after trauma, per day
    #> 77                                                                                                                Geriatric rehabilitation care other diagnoses, per day
    #> 78                                                                                                                                                Household help at home
    #> 79                                                                                                                                                 Personal care at home
    #> 80                                                                                                                                            Guidance at home, per hour
    #> 81                                                                                                                                             Nursing at home, per hour
    #> 82                                                                                                                                           Treatment at home, per hour
    #> 83                                                                                                                                               Travel costs, per visit
    #> 84                                                                                 POH-GGZ, average consultation (also applicable for telephone and e-mail consultation)
    #> 85                                                                 POH-GGZ, consultation shorter than 20 minutes (also applicable for telephone and e-mail consultation)
    #> 86                                                                  POH-GGZ, consultation longer than 20 minutes (also applicable for telephone and e-mail consultation)
    #> 87                                                                                                                                           POH-GGZ, average home visit
    #> 88                                                                                                                           POH-GGZ, home visit shorter than 20 minutes
    #> 89                                                                                                                            POH-GGZ, home visit longer than 20 minutes
    #> 90                                                                                                                                           POH-GGZ, Group consultation
    #> 91                                                                                                                                                   Contact social work
    #> 92                                                                                                   Contact independent healthcare provider in basic mental health care
    #> 93                                                                                          Contact healthcare provider in general basic mental health care institutions
    #> 94                                                                                             Contact independent healthcare provider in specialized mental health care
    #> 95                                                                                            Contact healthcare provider in specialized mental health care institutions
    #> 96                                                                                                                           Contact healthcare provider in the PAAZ/PUK
    #> 97                                                                                                                                  Nursing day, psychiatric institution
    #> 98                                                                                                                                                 Nursing day, PAAZ/PUK
    #> 99                                                                                                           Daytime activities half day, specialized mental health care
    #> 100                                                                                                           Rehabilitation treatment consultation, children and adults
    #> 101                                                                                                                      Rehabilitation treatment consultation, children
    #> 102                                                                                                                        Rehabilitation treatment consultation, adults
    #> 103                                                                        Nursing day rehabilitation center, children and adults (incl. rehabilitation treatment hours)
    #> 104                                                                                   Nursing day rehabilitation center, children (incl. rehabilitation treatment hours)
    #> 105                                                                                     Nursing day rehabilitation center, adults (incl. rehabilitation treatment hours)
    #> 106                                                                                     Care with residence (per day), intellectually disabled, incl. daytime activities
    #> 107                                                                                     Care with residence (per day), intellectually disabled, excl. daytime activities
    #> 108                                                                              Care with residence (per day), mildly intellectually disabled, incl. daytime activities
    #> 109                                              Care with residence (per day), severely behaviorally disturbed mildly intellectually disabled, incl. daytime activities
    #> 110                                                                                         Care with residence (per day), physically disabled, incl. daytime activities
    #> 111                                                                                         Care with residence (per day), physically disabled, excl. daytime activities
    #> 112                                                                       Care with residence (per day), auditory and communicatively disabled, incl. daytime activities
    #> 113                                                                       Care with residence (per day), auditory and communicatively disabled, excl. daytime activities
    #> 114                                                                                           Care with residence (per day), visually disabled, incl. daytime activities
    #> 115                                                                                           Care with residence (per day), visually disabled, excl. daytime activities
    #> 116                                                                                                                                                         order tariff
    #> 117                                                                                                                                              Car, cost per kilometer
    #> 118                                                                                                                                          Car, parking cost per visit
    #> 119                                                                                                                                 Public transport, cost per kilometer
    #> 120                                                                                                                                 Taxi & WMO transport (starting rate)
    #> 121                                                                                                                           Taxi & WMO transport (price per kilometer)
    #> 122                                                                                                        Time costs of informal caregivers, replacement costs per hour
    #> 123                                                                                                                          Productivity costs per hour per paid worker
    #> 124                                                                                                                                           Replacement costs per hour
    #> 125                                                                                                                                           Primary education per year
    #> 126                                                                                                                                            Primary education per day
    #> 127                                                                                                                                           Primary education per hour
    #> 128                                                                                                                                         Secondary education per year
    #> 129                                                                                                                                          Secondary education per day
    #> 130                                                                                                                                         Secondary education per hour
    #> 131                                                                                                                                        Vocational education per year
    #> 132                                                                                                                                         Vocational education per day
    #> 133                                                                                                                                        Vocational education per hour
    #> 134                                                                                                                               Higher professional education per year
    #> 135                                                                                                                                Higher professional education per day
    #> 136                                                                                                                               Higher professional education per hour
    #> 137                                                                                                                                        Scientific education per year
    #> 138                                                                                                                                         Scientific education per day
    #> 139                                                                                                                                        Scientific education per hour
    #> 140                                                                                                                                 Special (primary) education per year
    #> 141                                                                                                                                  Special (primary) education per day
    #> 142                                                                                                                                 Special (primary) education per hour
    #> 143                                                                                                                                         Tutoring by student per hour
    #> 144                                                                                                                                         Tutoring by teacher per hour
    #> 145                                                                                                                                           Remedial teaching per hour
    #> 146                                                                                                                                          Robbery/theft with violence
    #> 147                                                                                                                                           Simple theft/pickpocketing
    #> 148                                                                                                                                                Handling stolen goods
    #> 149                                                                                                                  Destruction/vandalism of private or public property
    #> 150                                                                                                                                    Disorderly conduct/discrimination
    #> 151                                                                                                                                                                Arson
    #> 152                                                                                                                                                           Cybercrime
    #> 153                                                                                                                                            Simple and severe assault
    #> 154                                                                                                                                                 Threatening behavior
    #> 155                                                                                                                                                Forced sexual contact
    #> 156                                                                                                                                                 Unauthorized driving
    #> 157                                                                                                                                          Driving under the influence
    #> 158                                                                                                                                                   Selling soft drugs
    #> 159                                                                                                                                                   Selling hard drugs
    #> 160                                                                                                                                                    (Fire)arm offense
    #>                            short_var      2022         2023         2024
    #> 1          nursingday_excl_personnel    537.00    557.40600    576.20100
    #> 2          nursingday_incl_personnel    644.00    668.47200    691.01200
    #> 3           nursingday_intensivecare   2727.00   2830.62600   2926.07100
    #> 4              daytreatment_hospital    335.00    347.73000    359.45500
    #> 5                  iv_admin_hospital    171.00    177.49800    183.48300
    #> 6                  sc_admin_hospital     75.28     78.14064     80.77544
    #> 7          outpatient_visit_hospital    120.00    124.56000    128.76000
    #> 8                     emergency_care    258.00    267.80400    276.83400
    #> 9                 ambulance_weighted    528.00    548.06400    566.54400
    #> 10                 ambulance_ordered    293.00    304.13400    314.38900
    #> 11                  ambulance_urgent    657.00    681.96600    704.96100
    #> 12    operatingroom_conventional_min     11.09     11.51142     11.89957
    #> 13          operatingroom_hybrid_min     23.34     24.22692     25.04382
    #> 14                       mri_general    267.00    277.14600    286.49100
    #> 15              mri_lowerextremities    264.00    274.03200    283.27200
    #> 16                         mri_brain    254.00    263.65200    272.54200
    #> 17                   mri_lumbosacral    227.00    235.62600    243.57100
    #> 18            mri_shoulders_upperext    271.00    281.29800    290.78300
    #> 19                       mri_abdomen    342.00    354.99600    366.96600
    #> 20                        ct_general    188.00    195.14400    201.72400
    #> 21               ct_abdomen_contrast    214.00    222.13200    229.62200
    #> 22                ct_thorax_contrast    196.00    203.44800    210.30800
    #> 23                 ct_brain_contrast    153.00    158.81400    164.16900
    #> 24      ct_lowerextremities_contrast    179.00    185.80200    192.06700
    #> 25           ct_facialskull_contrast    147.00    152.58600    157.73100
    #> 26                     spect_general    445.00    461.91000    477.48500
    #> 27                    spect_skeleton    266.00    276.10800    285.41800
    #> 28                   spect_heart_ecg    515.00    534.57000    552.59500
    #> 29                       spect_brain    626.00    649.78800    671.69800
    #> 30                     spect_abdomen    323.00    335.27400    346.57900
    #> 31                       pet_general    963.00    999.59400   1033.29900
    #> 32                     pet_wholebody    971.00   1007.89800   1041.88300
    #> 33                       pet_partial    700.00    726.60000    751.10000
    #> 34                ultrasound_general    103.00    106.91400    110.51900
    #> 35              ultrasound_abdominal    118.00    122.48400    126.61400
    #> 36               ultrasound_lowerext     97.16    100.85208    104.25268
    #> 37              ultrasound_pregnancy     85.76     89.01888     92.02048
    #> 38                 ultrasound_breast     95.80     99.44040    102.79340
    #> 39           ultrasound_thyroid_neck     91.08     94.54104     97.72884
    #> 40                         xray_exam     82.17     85.29246     88.16841
    #> 41                 bp24h_measurement     86.78     90.07764     93.11494
    #> 42                          crp_test      4.38      4.54644      4.69974
    #> 43                        hba1c_test      4.52      4.69176      4.84996
    #> 44                          tsh_test      4.14      4.29732      4.44222
    #> 45                   creatinine_test      1.49      1.54662      1.59877
    #> 46              creatinine_clearance      6.14      6.37332      6.58822
    #> 47                         alat_test      1.74      1.80612      1.86702
    #> 48                    prosthesis_arm   3540.00   3674.52000   3798.42000
    #> 49                    prosthesis_leg   2790.00   2896.02000   2993.67000
    #> 50                 aid_comm_physical   1550.00   1608.90000   1663.15000
    #> 51                   aid_comm_visual   1230.00   1276.74000   1319.79000
    #> 52                    aid_comm_other   1170.00   1214.46000   1255.41000
    #> 53                aid_mobility_other   1040.00   1079.52000   1115.92000
    #> 54                aid_diabetes_other    974.00   1011.01200   1045.10200
    #> 55                 aid_armhandfinger    927.00    962.22600    994.67100
    #> 56                 orthopaedic_shoes    889.00    922.78200    953.89700
    #> 57              optical_aids_special    731.00    758.77800    784.36300
    #> 58                    gp_consult_avg     30.87     32.04306     33.12351
    #> 59                  gp_consult_short     28.74     29.83212     30.83802
    #> 60                   gp_consult_long     42.47     44.08386     45.57031
    #> 61                  gp_homevisit_avg     43.31     44.95578     46.47163
    #> 62                gp_homevisit_short     36.72     38.11536     39.40056
    #> 63                 gp_homevisit_long     48.21     50.04198     51.72933
    #> 64             physiotherapy_session     38.89     40.36782     41.72897
    #> 65          exercise_therapy_session     42.91     44.54058     46.04243
    #> 66            speech_therapy_session     40.93     42.48534     43.91789
    #> 67      occupational_therapy_session     24.32     25.24416     26.09536
    #> 68               diet_advice_session     24.70     25.63860     26.50310
    #> 69                     gli_programme    128.00    132.86400    137.34400
    #> 70                   nursingcare_day    290.00    301.02000    311.17000
    #> 71             dayactivities_halfday     83.29     86.45502     89.37017
    #> 72               geriatric_rehab_avg    329.00    341.50200    353.01700
    #> 73        geriatric_rehab_amputation    306.00    317.62800    328.33800
    #> 74            geriatric_rehab_stroke    357.00    370.56600    383.06100
    #> 75          geriatric_rehab_elective    360.00    373.68000    386.28000
    #> 76            geriatric_rehab_trauma    331.00    343.57800    355.16300
    #> 77             geriatric_rehab_other    311.00    322.81800    333.70300
    #> 78                homecare_household     32.76     34.00488     35.15148
    #> 79                 homecare_personal     57.58     59.76804     61.78334
    #> 80            homecare_guidance_hour     64.00     66.43200     68.67200
    #> 81             homecare_nursing_hour     75.00     77.85000     80.47500
    #> 82           homecare_treatment_hour    138.00    143.24400    148.07400
    #> 83                   homecare_travel     30.64     31.80432     32.87672
    #> 84                pohggz_consult_avg     20.85     21.64230     22.37205
    #> 85              pohggz_consult_short      9.31      9.66378      9.98963
    #> 86               pohggz_consult_long     23.12     23.99856     24.80776
    #> 87                   pohggz_home_avg     28.50     29.58300     30.58050
    #> 88                 pohggz_home_short     17.34     17.99892     18.60582
    #> 89                  pohggz_home_long     28.91     30.00858     31.02043
    #> 90                      pohggz_group     11.56     11.99928     12.40388
    #> 91                    mhc_socialwork    127.00    131.82600    136.27100
    #> 92             mhc_basic_independent     98.61    102.35718    105.80853
    #> 93             mhc_basic_institution    121.00    125.59800    129.83300
    #> 94       mhc_specialised_independent    140.00    145.32000    150.22000
    #> 95       mhc_specialised_institution    134.00    139.09200    143.78200
    #> 96                      mhc_paaz_puk    148.00    153.62400    158.80400
    #> 97           mhc_nursingday_psy_inst    327.00    339.42600    350.87100
    #> 98           mhc_nursingday_paaz_puk    490.00    508.62000    525.77000
    #> 99         mhc_dayactivities_halfday     22.81     23.67678     24.47513
    #> 100                rehab_consult_all    371.00    385.09800    398.08300
    #> 101           rehab_consult_children    497.00    515.88600    533.28100
    #> 102             rehab_consult_adults    347.00    360.18600    372.33100
    #> 103             rehab_nursingday_all    910.00    944.58000    976.43000
    #> 104        rehab_nursingday_children   1368.00   1419.98400   1467.86400
    #> 105          rehab_nursingday_adults    849.00    881.26200    910.97700
    #> 106 disability_res_intellectual_incl    282.00    292.71600    302.58600
    #> 107 disability_res_intellectual_excl    163.00    169.19400    174.89900
    #> 108         disability_res_mild_incl    345.00    358.11000    370.18500
    #> 109    disability_res_behaviour_incl    458.00    475.40400    491.43400
    #> 110     disability_res_physical_incl    301.00    312.43800    322.97300
    #> 111     disability_res_physical_excl    234.00    242.89200    251.08200
    #> 112     disability_res_auditory_incl    429.00    445.30200    460.31700
    #> 113     disability_res_auditory_excl    263.00    272.99400    282.19900
    #> 114       disability_res_visual_incl    277.00    287.52600    297.22100
    #> 115       disability_res_visual_excl    208.00    215.90400    223.18400
    #> 116                     order_tariff      4.22      4.38036      4.52806
    #> 117                 transport_car_km      0.26      0.26988      0.27898
    #> 118            transport_car_parking      3.92      4.06896      4.20616
    #> 119                  transport_pt_km      0.21      0.21798      0.22533
    #> 120             transport_taxi_start      3.36      3.48768      3.60528
    #> 121                transport_taxi_km      2.47      2.56386      2.65031
    #> 122           timecost_informal_hour     18.80     19.51440     20.17240
    #> 123               prodloss_paid_hour     39.88     41.39544     42.79124
    #> 124             prodloss_unpaid_hour     18.80     19.51440     20.17240
    #> 125                 edu_primary_year   9846.00  10220.14800  10564.75800
    #> 126                  edu_primary_day     52.10     54.07980     55.90330
    #> 127                 edu_primary_hour     10.47     10.86786     11.23431
    #> 128               edu_secondary_year  14342.00  14886.99600  15388.96600
    #> 129                edu_secondary_day     75.88     78.76344     81.41924
    #> 130               edu_secondary_hour     15.26     15.83988     16.37398
    #> 131              edu_vocational_year  19251.00  19982.53800  20656.32300
    #> 132               edu_vocational_day    103.00    106.91400    110.51900
    #> 133              edu_vocational_hour     20.77     21.55926     22.28621
    #> 134              edu_higherprof_year  15963.00  16569.59400  17128.29900
    #> 135               edu_higherprof_day     84.46     87.66948     90.62558
    #> 136              edu_higherprof_hour     16.98     17.62524     18.21954
    #> 137              edu_scientific_year  29735.00  30864.93000  31905.65500
    #> 138               edu_scientific_day    157.33    163.30854    168.81509
    #> 139              edu_scientific_hour     31.63     32.83194     33.93899
    #> 140             edu_specialprim_year  15855.00  16457.49000  17012.41500
    #> 141              edu_specialprim_day     83.89     87.07782     90.01397
    #> 142             edu_specialprim_hour     16.87     17.51106     18.10151
    #> 143        edu_tutoring_student_hour     15.00     15.57000     16.09500
    #> 144        edu_tutoring_teacher_hour     30.00     31.14000     32.19000
    #> 145                edu_remedial_hour     40.00     41.52000     42.92000
    #> 146         justice_robbery_violence  13855.00  14381.49000  14866.41500
    #> 147             justice_theft_simple   3147.00   3266.58600   3376.73100
    #> 148             justice_stolen_goods    929.00    964.30200    996.81700
    #> 149                justice_vandalism   8809.00   9143.74200   9452.05700
    #> 150                 justice_disorder   3605.00   3741.99000   3868.16500
    #> 151                    justice_arson  14627.00  15182.82600  15694.77100
    #> 152               justice_cybercrime 106076.00 110106.88800 113819.54800
    #> 153                  justice_assault  19927.00  20684.22600  21381.67100
    #> 154                   justice_threat  23451.00  24342.13800  25162.92300
    #> 155            justice_forced_sexual   4088.00   4243.34400   4386.42400
    #> 156     justice_unauthorised_driving   7086.00   7355.26800   7603.27800
    #> 157                      justice_dui   1424.00   1478.11200   1527.95200
    #> 158           justice_sell_softdrugs   5612.00   5825.25600   6021.67600
    #> 159           justice_sell_harddrugs  32335.00  33563.73000  34695.45500
    #> 160          justice_firearm_offence  32333.00  33561.65400  34693.30900

### 2) Specific year* & unit -> single value

    nl_ref_prices(year = 2022, unit = "Emergency care")
    #> 258
    #> Price in 2022 per Emergency care
    #> [1] 258

### 3) Years values for a range of years

    nl_ref_prices(year = 2022:2024, category = "Nursing")
    #> # A tibble: 9 × 6
    #>   Domain  Category Unit                                    short_var Year  Price
    #>   <chr>   <chr>    <chr>                                   <chr>     <chr> <dbl>
    #> 1 Medical Nursing  Nursing day excluding personnel costs,… nursingd… 2022   537
    #> 2 Medical Nursing  Nursing day excluding personnel costs,… nursingd… 2023   557.
    #> 3 Medical Nursing  Nursing day excluding personnel costs,… nursingd… 2024   576.
    #> 4 Medical Nursing  Nursing day including personnel costs,… nursingd… 2022   644
    #> 5 Medical Nursing  Nursing day including personnel costs,… nursingd… 2023   668.
    #> 6 Medical Nursing  Nursing day including personnel costs,… nursingd… 2024   691.
    #> 7 Medical Nursing  Nursing day, intensive care (incl. dia… nursingd… 2022  2727
    #> 8 Medical Nursing  Nursing day, intensive care (incl. dia… nursingd… 2023  2831.
    #> 9 Medical Nursing  Nursing day, intensive care (incl. dia… nursingd… 2024  2926.

### 4) Multiple selections return multiple columns

    # nl_ref_prices(
    #   year     = 2024,
    #   category = "Nursing",
    #   unit     = c("Nursing day excluding personnel costs, hospital",
    #                "Nursing day including personnel costs, hospital")
    # )

## Error messages you might see

- “Year out of range …” You asked for a year outside the available year columns in `df_ref_prices`. Use a valid year or pass `"all"` for all years.

- “For output =”value_label”, provide exactly one year and a single (category, unit) combination.” Single value mode needs exactly one year and one (`category`, `unit`) (and, if used, a single domain) so that exactly one row remains.