This article assumes:
- You have a Tidepool Web account - Signing up for Tidepool
- Made some notes on your Tidepool Web account
Downloading all of your Note data from the command-line
1a. On a Mac
Open Terminal, either by searching for it, or by navigating through the following:
- On OS X, open your Applications folder.
- Then open the folder.
- Open the Terminal application.
1b. On a PC
Open Command Prompt — the easiest way to do this is by searching for it in the taskbar.
2. Running the queries on Terminal or Command-Line
After you open Terminal or command line, type the following, replacing:
curl -v -X POST -u <email@example.com> https://api.tidepool.org/auth/login
After hitting enter, you will be prompted for your password.
You will then receive a blurb similar to:
HTTP/1.1 200 OK access-control-allow-headers: authorization, content-type, x-tidepool-session-token access-control-allow-methods: GET, POST, PUT access-control-allow-origin: * access-control-expose-headers: x-tidepool-session-token access-control-max-age: 0 content-type: application/json date: Wed, 10 Feb 2016 21:00:21 GMT x-tidepool-session-token: eXYZyJhbGciOiJIUzI1NiaIsInR5cCI6IkwerwpXVCJ9.eyJkdXIiOjIuNTkyZSswNiwiZXhwIjox12345zMwMDIxLCJzdnIiOiJubyIsInVzciI6ImI0NTFhNmEwNDcifQ.WolTlCFxCIJjf5AbjabcdePqXztSxezUYzY-gwIJH-g Content-Length: 170 Connection: keep-alive
The two important parts of this response are:
- x-tidepool-session-token: eXYZy...IJH-g in this example
- unique userID for your account: 0460512abc in this example
You will then take your Session Token and userID and use them in a new query:
curl -s -X GET -H "x-tidepool-session-token: <your-session-token>" -H "Content-Type: application/json" 'https://api.tidepool.org/message/notes/<userid>' > data_download.json
Again, please replace <your-session-token> with your actual x-tidepool-session-token value, and replace <userid> with your userID value from above. You can change "data_download.json" to any file name you like.
Optionally, specify start time and end time in ISO date/time format (e.g. "?starttime=2015-10-10T15:00: 00.000Z&endtime=2015-10-11T15: 00:00.000Z").
After hitting enter, a file called data_download.json will appear on your computer. The easiest way to find this file is to search for it by name using your computer's search functionality.
Please reach out to firstname.lastname@example.org if you have any questions or feedback on this article.