Skip to content

ipumsr

An R Interface for Downloading, Reading, and Handling IPUMS Data

v0.10.0 · Mar 13, 2026 · Mozilla Public License 2.0

Description

An easy way to work with census, survey, and geographic data provided by IPUMS in R. Generate and download data through the IPUMS API and load IPUMS files into R with their associated metadata to make analysis easier. IPUMS data describing 1.4 billion individuals drawn from over 750 censuses and surveys is available free of charge from the IPUMS website <https://www.ipums.org>.

Downloads

6K

Last 30 days

1602nd

16.2K

Last 90 days

56K

Last year

Trend: +3.6% (30d vs prior 30d)

CRAN Check Status

14 OK
Show all 14 flavors
Flavor Status
r-devel-linux-x86_64-debian-clang OK
r-devel-linux-x86_64-debian-gcc OK
r-devel-linux-x86_64-fedora-clang OK
r-devel-linux-x86_64-fedora-gcc OK
r-devel-macos-arm64 OK
r-devel-windows-x86_64 OK
r-oldrel-macos-arm64 OK
r-oldrel-macos-x86_64 OK
r-oldrel-windows-x86_64 OK
r-patched-linux-x86_64 OK
r-release-linux-x86_64 OK
r-release-macos-arm64 OK
r-release-macos-x86_64 OK
r-release-windows-x86_64 OK

Check History

OK 14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE Mar 17, 2026
ERROR 10 OK · 0 NOTE · 0 WARNING · 4 ERROR · 0 FAILURE Mar 10, 2026
ERROR r-devel-linux-x86_64-debian-clang

tests

Running ‘testthat.R’ [86s/128s]
Running the tests in ‘tests/testthat.R’ failed.
Complete output:
  > # This file is part of the standard setup for testthat.
  > # It is recommended that you do not modify it.
  > #
  > # Where should you do additional
...[truncated]...
, basename(x))
   6.       │ └─base::is.factor(x)
   7.       └─base::basename(x)
  
  [ FAIL 13 | WARN 0 | SKIP 6 | PASS 838 ]
  Error:
  ! Test failures.
  Warning message:
  `check_cassette_names()` was deprecated in vcr 2.0.0. 
  Execution halted
ERROR r-devel-linux-x86_64-debian-gcc

tests

Running ‘testthat.R’ [66s/105s]
Running the tests in ‘tests/testthat.R’ failed.
Complete output:
  > # This file is part of the standard setup for testthat.
  > # It is recommended that you do not modify it.
  > #
  > # Where should you do additional
...[truncated]...
, basename(x))
   6.       │ └─base::is.factor(x)
   7.       └─base::basename(x)
  
  [ FAIL 13 | WARN 0 | SKIP 6 | PASS 838 ]
  Error:
  ! Test failures.
  Warning message:
  `check_cassette_names()` was deprecated in vcr 2.0.0. 
  Execution halted
ERROR r-devel-linux-x86_64-fedora-clang

tests

Running ‘testthat.R’ [135s/400s]
Running the tests in ‘tests/testthat.R’ failed.
Complete output:
  > # This file is part of the standard setup for testthat.
  > # It is recommended that you do not modify it.
  > #
  > # Where should you do additiona
...[truncated]...
, basename(x))
   6.       │ └─base::is.factor(x)
   7.       └─base::basename(x)
  
  [ FAIL 13 | WARN 0 | SKIP 6 | PASS 838 ]
  Error:
  ! Test failures.
  Warning message:
  `check_cassette_names()` was deprecated in vcr 2.0.0. 
  Execution halted
ERROR r-devel-windows-x86_64

examples

Running examples in 'ipumsr-Ex.R' failed
The error most likely occurred in:

> ### Name: read_ipums_ddi
> ### Title: Read metadata about an IPUMS microdata extract from a DDI
> ###   codebook (.xml) file
> ### Aliases: read_ipums_ddi
> 
> ### ** Exam
...[truncated]...
di_file)
> 
> # Use the object to load its associated data
> cps <- read_ipums_micro(ddi)
Error in basename(x) : a character vector argument expected
Calls: read_ipums_micro ... <Anonymous> -> ifelse -> grepl -> is.factor -> basename
Execution halted

Reverse Dependencies (3)

Dependency Network

Dependencies Reverse dependencies dplyr haven hipread httr jsonlite lifecycle purrr R6 readr rlang tibble tidyselect xml2 zeallot Ecfun MaddisonData metasurvey ipumsr

Version History

updated 0.10.0 ← 0.9.0 diff Mar 13, 2026
new 0.9.0 Mar 10, 2026
updated 0.9.0 ← 0.8.2 diff Jun 3, 2025
updated 0.8.2 ← 0.8.1 diff Feb 23, 2025
updated 0.8.1 ← 0.8.0 diff Jul 16, 2024
updated 0.8.0 ← 0.7.2 diff Jul 9, 2024
updated 0.7.2 ← 0.7.1 diff Mar 11, 2024
updated 0.7.1 ← 0.7.0 diff Feb 25, 2024
updated 0.7.0 ← 0.6.3 diff Oct 19, 2023
updated 0.6.3 ← 0.6.2 diff Sep 1, 2023
updated 0.6.2 ← 0.6.1 diff Aug 22, 2023
updated 0.6.1 ← 0.6.0 diff Aug 17, 2023
updated 0.6.0 ← 0.5.2 diff Jul 20, 2023
updated 0.5.2 ← 0.5.1 diff Dec 8, 2022
updated 0.5.1 ← 0.5.0 diff Sep 29, 2022
updated 0.5.0 ← 0.4.5 diff Jun 4, 2022
updated 0.4.5 ← 0.4.4 diff Jul 21, 2020
updated 0.4.4 ← 0.4.3 diff Jun 2, 2020
updated 0.4.3 ← 0.4.2 diff Apr 30, 2020
updated 0.4.2 ← 0.4.1 diff Jun 3, 2019