Precipitation & Weather Data API

Soil Data

Endpointhttps://api.precip.ai

Endpoints for soil moisture and temperature data

Daily Soil Moisture

GET

https://api.precip.ai

/api/v1/soil-moisture-daily

Daily soil moisture percentage relative to holding capacity at 0-10cm depth

Daily Soil Moisture › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · required

comma separated list of longitudes

Example: -122.42616,-71.06053,-90.07447

Default: -122.42616,-71.06053,-90.07447

latitude

string · required

comma separated list of latitudes

Example: 37.75750,42.35355,29.97991

Default: 37.75750,42.35355,29.97991

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Daily Soil Moisture › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Daily Soil Moisture › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/soil-moisture-daily

curl --request GET \
  --url 'https://api.precip.ai/api/v1/soil-moisture-daily?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "days": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Hourly Soil Moisture

GET

https://api.precip.ai

/api/v1/soil-moisture-hourly

Hourly soil moisture percentage relative to holding capacity at 0-10cm depth

Hourly Soil Moisture › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · required

comma separated list of longitudes

Example: -122.42616,-71.06053,-90.07447

Default: -122.42616,-71.06053,-90.07447

latitude

string · required

comma separated list of latitudes

Example: 37.75750,42.35355,29.97991

Default: 37.75750,42.35355,29.97991

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Hourly Soil Moisture › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Hourly Soil Moisture › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/soil-moisture-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/soil-moisture-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Soil Temperature

GET

https://api.precip.ai

/api/v1/temp-0-10cm-hourly

Hourly soil temperature data at 0-10cm depth in Celsius (°C)

Soil Temperature › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Soil Temperature › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Soil Temperature › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/temp-0-10cm-hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/temp-0-10cm-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "hours": [
          {
            "startTime": "2024-08-25T15:00:00Z",
            "precip": 0,
            "precip_probability": {},
            "precip_type": "rain",
            "source": "observation"
          }
        ],
        "timeZoneId": "timeZoneId"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

Precipitation Data Atmospheric Data

Daily Soil Moisture

GET

https://api.precip.ai

/api/v1/soil-moisture-daily

Daily soil moisture percentage relative to holding capacity at 0-10cm depth

Daily Soil Moisture › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · required

comma separated list of longitudes

Example: -122.42616,-71.06053,-90.07447

Default: -122.42616,-71.06053,-90.07447

latitude

string · required

comma separated list of latitudes

Example: 37.75750,42.35355,29.97991

Default: 37.75750,42.35355,29.97991

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Daily Soil Moisture › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Daily Soil Moisture › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

curl --request GET \ --url 'https://api.precip.ai/api/v1/soil-moisture-daily?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \ --header 'Authorization: <string>'

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": { "days": [ { "startTime": "2024-08-25T15:00:00Z", "precip": 0, "precip_probability": {}, "precip_type": "rain", "source": "observation" } ], "timeZoneId": "timeZoneId" }, "geometry": { "type": "Point", "coordinates": [ 0 ] } } ] }

Hourly Soil Moisture

GET

https://api.precip.ai

/api/v1/soil-moisture-hourly

Hourly soil moisture percentage relative to holding capacity at 0-10cm depth

Hourly Soil Moisture › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · required

comma separated list of longitudes

Example: -122.42616,-71.06053,-90.07447

Default: -122.42616,-71.06053,-90.07447

latitude

string · required

comma separated list of latitudes

Example: 37.75750,42.35355,29.97991

Default: 37.75750,42.35355,29.97991

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Hourly Soil Moisture › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Hourly Soil Moisture › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

curl --request GET \ --url 'https://api.precip.ai/api/v1/soil-moisture-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \ --header 'Authorization: <string>'

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": { "hours": [ { "startTime": "2024-08-25T15:00:00Z", "precip": 0, "precip_probability": {}, "precip_type": "rain", "source": "observation" } ], "timeZoneId": "timeZoneId" }, "geometry": { "type": "Point", "coordinates": [ 0 ] } } ] }

Soil Temperature

GET

https://api.precip.ai

/api/v1/temp-0-10cm-hourly

Hourly soil temperature data at 0-10cm depth in Celsius (°C)

Soil Temperature › query Parameters

start

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-01

Default: 2025-06-01

end

string · required

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S

Example: 2025-06-30

Default: 2025-06-30

longitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of longitude coordinates (WGS84)

Default: -122.42616,-71.06053,-90.07447

latitude

string · pattern: ^-?\d+(\.\d+)?(,-?\d… · required

Comma-separated list of latitude coordinates (WGS84)

Default: 37.75750,42.35355,29.97991

timeZoneId

string · pattern: ^[A-Za-z_]+/[A-Za-z_…

IANA timezone identifier for localizing timestamps

Default: America/Chicago

format

Output format: geojson, json or csv

Default: json

Soil Temperature › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key.

Example: Bearer YOUR_API_KEY

Soil Temperature › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

curl --request GET \ --url 'https://api.precip.ai/api/v1/temp-0-10cm-hourly?start=2025-06-01&end=2025-06-30&longitude=-122.42616%2C-71.06053%2C-90.07447&latitude=37.75750%2C42.35355%2C29.97991' \ --header 'Authorization: <string>'