"# Release Notes for Soil API v1.0.0

## Date

September 22, 2025

## Overview

We are thrilled to announce the inaugural release of the DTN Soil API version 1.0.0! This release marks the availability of our comprehensive soil conditions data service, providing hourly and daily soil metrics for precision agriculture, weather services, and environmental monitoring. Read on to learn more about the features we're launching with, and how you can get started.

## Table of Contents

- [Initial Features](#initial-features)
- [Performance and Stability](#performance-and-stability)
- [How to Get Started](#how-to-get-started)
- [Support and Feedback](#support-and-feedback)

## Initial Features

- **Hourly and Daily Soil Conditions**: Access real-time and historical soil data including moisture, temperature, and more.
- **Flexible Time Ranges**: Query data with customizable time intervals and support for timezone-aware requests. Forecasts up to ten days in the future and historical data starting from 2013-01-01T00:00:00Z.
- **Parameter Discovery**: Explore available parameters through dedicated endpoints for soil conditions and climatology queries.
- **GeoJSON Response Format**: Easy-to-use GeoJSON FeatureCollection responses for seamless integration of geolocation data into your applications.
- **Unit System and Aggregation Support**: Choose between metric and imperial unit systems for your data needs as well as customizable aggregation periods.

## Performance and Stability

- Designed with scalability in mind, the Soil API is built to handle a large number of requests while maintaining high performance and stability.

## How to Get Started

1. **Obtain API Credentials**: Contact an account manager or the DTN sales team (https://www.dtn.com/contact-us/) to obtain your API credentials.
2. **Explore the Documentation**: Visit the API documentation at https://devportal.dtn.com/ to understand the available endpoints and their capabilities.
3. **Authentication**: Use JWT tokens with the appropriate scopes to authenticate your requests.
4. **Make Your First Request**: Start querying soil conditions data by providing latitude, longitude, and time parameters.

## Support and Feedback

For any issues, questions, or feedback, please:

- View our Contact Us at (https://www.dtn.com/contact-us/)
- Contact us at customerservice@dtn.com

Thank you for using the DTN Soil API. We're committed to making your experience better with every update.
"