lotus/documentation/en/retrieving-data.md

# Retrieving Data

> There are recent bug reports with these instructions. If you happen to encounter any problems, please create a [GitHub issue](https://github.com/filecoin-project/lotus/issues/new) and a maintainer will address the problem as soon as they can.

Here are the operations you can perform after you have stored and sealed a **Data CID** with the **Lotus Storage Miner** in the network.

If you would like to learn how to store a **Data CID** on a miner, read the instructions [here](https://docs.lotu.sh/en+storing-data).

## Find by Data CID

```sh
lotus client find <Data CID>
# LOCAL
# RETRIEVAL <miner>@<miner peerId>-<deal funds>-<size>
```

## Retrieve by Data CID

All fields are required.

```sh
lotus client retrieve <Data CID> <outfile>
```

If the outfile does not exist it will be created in the Lotus repository directory.

This command will initiate a **retrieval deal** and write the data to your computer. This process may take 2 to 10 minutes.
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			`# Retrieving Data`

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`> There are recent bug reports with these instructions. If you happen to encounter any problems, please create a [GitHub issue](https://github.com/filecoin-project/lotus/issues/new) and a maintainer will address the problem as soon as they can.`

documentation: updates from the testing session 2019-12-11 01:50:13 +00:00			`Here are the operations you can perform after you have stored and sealed a Data CID with the Lotus Storage Miner in the network.`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			`If you would like to learn how to store a Data CID on a miner, read the instructions [here](https://docs.lotu.sh/en+storing-data).`

			`## Find by Data CID`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus client find <Data CID>`
			`# LOCAL`
			`# RETRIEVAL <miner>@<miner peerId>-<deal funds>-<size>`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`## Retrieve by Data CID`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`All fields are required.`

documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus client retrieve <Data CID> <outfile>`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`If the outfile does not exist it will be created in the Lotus repository directory.`

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`This command will initiate a retrieval deal and write the data to your computer. This process may take 2 to 10 minutes.`