# Documenting a data extract for replication

**URL:** <https://forum.ipums.org/t/documenting-a-data-extract-for-replication/4984>\
**Category:** USA\
**Created:** [November 17, 2022, 7:42pm UTC](https://forum.ipums.org/t/documenting-a-data-extract-for-replication/4984 "2022-11-17T19:42:13Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Simon\_Brauer](https://avatars.discourse-cdn.com/v4/letter/s/aeb1de/32.png) [@Simon\_Brauer](https://forum.ipums.org/u/Simon_Brauer)\
**Post date:** [November 17, 2022, 7:42pm UTC](https://forum.ipums.org/t/documenting-a-data-extract-for-replication/4984/1 "2022-11-17T19:42:13Z")

</div>

I am working with IPUMS data (specifically the ACS 5-year and 1-year datasets) and would like to make my project as easy to replicate as possible. Is there functionality built into IPUMS to do this efficiently? I would ideally like to publish a link or file that allows others to download the data without having to go through and select the datasets and variables themselves.

---

<div class="post-metadata">

**Author:** ![KariWilliams](https://avatars.discourse-cdn.com/v4/letter/k/82dd89/32.png) [@KariWilliams](https://forum.ipums.org/u/KariWilliams)\
**Post date:** [November 23, 2022, 2:46pm UTC](https://forum.ipums.org/t/documenting-a-data-extract-for-replication/4984/2 "2022-11-23T14:46:04Z")

</div>

There are two options for this.

The first option is to request permission to redistribute the data file; you can submit a request by email to [ipums@umn.edu](mailto:ipums@umn.edu) with information about the sample(s) and variables included in your extract as well as information on the project and how you would like to redistribute the file (e.g., a public-facing GitHub repository for a journal article). The second option is to leverage the IPUMS microdata extract API; this functionality is currently in beta, but allows you to share an extract definition that others can submit via an API call (see information on how to do this with [R](https://blog.popdata.org/reproducible-research-r-markdown-ipumsr-ipums-api/) and with [Python](https://blog.popdata.org/sharing-ipums-extract-definitions-using-ipumspy/)). Note that because the microdata extract API is currently in beta it does not support all extract features (e.g., select cases).
