Request for a Client ID to set up an authorized session for code generated data download

[ASDC - micook]

To whom it may concern,
I hope this email finds you well.
We are interested in downloading ozone profile data from 2017 to 2025 for an academic study. I have created a user account on the Earthdata portal with the username noamginio@gmail.com.
As per the API instructions, I need to set up an authorized session, which requires a client ID. I would appreciate your assistance in providing the necessary credentials to enable this setup.
Thank you for your time and support. I look forward to your response.
All the best,

[ASDC - cheyenne.e.land]

Hello,

Where are you trying to download ozone profile data from? Also can you provide the link to the API instructions?

Thank you,
ASDC

[ASDC - micook]

Thank you for your prompt response, and please excuse my delayed reply. I’m currently trying to download the TOLNet datasets (differential LIDAR), and I’ve found the following API link where I’m prompted for a client ID:
https://tolnet.larc.nasa.gov/api/index.html
I’ve also downloaded the dataset manually from Earthdata Search, but the files there come in several formats (such as .ict, .dat, and .hdf). If there’s a way to download all the TOLNet data in a single file format (to avoid potential transformation errors), that would be extremely helpful.
Thank you for your assistance, and I look forward to hearing from you.
All the best,

[crystal]

You can leave client_ID blank. My apologies for the confusion in the user interface.

The API will then open a separate window to take you through the normal Earthdata Login process, which will be the same user name and password you used on the Earthdata Portal.

Once you are successfully logged on, you can go back to the tab with the TOLNet API and you should be able to download data.

You would use the /data/ API endpoint to get the id's of the files you want to download. Learn more here: https://tolnet.larc.nasa.gov/api/index.html#/Data/getData

And you would use the /data/download API endpoint to actually download the data. Learn more here: https://tolnet.larc.nasa.gov/api/index.html#/Data/getDataDownload

That last link will also take you to instructions on how to authorize your session on the command line as well.

Please let us know if you have any followup questions.

[ASDC - micook]

Thank you again for your prompt response. As I mentioned, I’ve already downloaded the data manually from Earthdata Search, but the files come in various formats (e.g., .ict, .dat, .hdf4). Could you or the TOLNet expert you’re in contact with please clarify whether it’s possible—via the TOLNet API—to specify a single file format for download?

If not, might they be able to provide a script, directions, or pointers on how best to convert between .ict, .dat, and .hdf4 formats? This would help us avoid potential transformation errors.

Thank you for your assistance, and I look forward to hearing from you.

[crystal]

Currently, the TOLNet API only allows you to download data in the same format that the science team members uploaded it in. Which is almost always HDF4.

I've reached out to a TOLNet data subject matter expert to see if he has advice for you regarding how best to convert between formats.

[ASDC - mshook]

In cases where there is data in multiple formats for the same period, you should use the .hdf (HDF4-GEOMS) version if available. In cases where a corresponding .hdf file is not available, we recommend reaching out to the instrument PI (contact info listed in each file header) or to the TOLNet PI (John Sullivan). Unfortunately, we do not have scripts or sample code for file conversion readily available for you, but you can use cases with multiple formats for the same data period as examples of how to convert from .dat to .hdf when necessary. For this time range, all .ict (ICARTT) files are either lidar data that is also available in .hdf format or surface data, and should not be used.

For a full discussion on TOLNet data formats, please see this forum post.