Precipitation Data

Endpointhttps://api.precip.ai

Endpoints for retrieving precipitation measurements and forecasts

Daily Precipitation Data

GET

https://api.precip.ai

/api/v1/daily

Returns comprehensive daily precipitation data for the given time range and location(s). Each day includes precipitation amount, type (rain/snow/mixed), probability (for forecasts), and data source. Seamlessly combines historical observations with forecast data depending on the requested time range.

Daily Precipitation Data › query Parameters

start

string · required

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

Example: 2024-01-04

Default: 2024-01-04

end

string · required

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

Example: 2024-02-04

Default: 2024-02-04

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Daily Precipitation Data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Daily Precipitation Data › Responses

Daily precipitation data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/daily

curl --request GET \
  --url 'https://api.precip.ai/api/v1/daily?start=2024-01-04&end=2024-02-04&longitude=-122.42616&latitude=37.75750' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -84.281508334,
          43.631819304
        ]
      },
      "properties": {
        "days": [
          {
            "precip": 0,
            "precip_probability": null,
            "precip_type": "rain",
            "startTime": "2024-06-11T12:00:00+0000",
            "source": "observation"
          },
          {
            "precip": 4.7,
            "precip_probability": null,
            "precip_type": "rain",
            "startTime": "2025-06-09T12:00:00+0000",
            "source": "observation"
          },
          {
            "precip": 0.8,
            "precip_probability": 22,
            "precip_type": "rain",
            "startTime": "2025-06-12T12:00:00+0000",
            "source": "forecast"
          },
          {
            "precip": 5.4,
            "precip_probability": null,
            "precip_type": "snow",
            "startTime": "2024-12-04T12:00:00+0000",
            "source": "observation"
          }
        ],
        "timeZoneId": "GMT"
      }
    }
  ]
}

json

application/json

Hourly Precipitation Data

GET

https://api.precip.ai

/api/v1/hourly

Returns comprehensive hourly precipitation data for the given time range and location(s). Each hour includes precipitation amount, type (rain/snow/mixed), probability (for forecasts), and data source. Seamlessly combines historical observations with forecast data depending on the requested time range.

Hourly Precipitation Data › query Parameters

start

string · required

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

Example: 2024-01-04

Default: 2024-01-04

end

string · required

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

Example: 2024-02-04

Default: 2024-02-04

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Hourly Precipitation Data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Hourly Precipitation Data › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/hourly

curl --request GET \
  --url 'https://api.precip.ai/api/v1/hourly?start=2024-01-04&end=2024-02-04&longitude=-122.42616&latitude=37.75750' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -84.281508334,
          43.631819304
        ]
      },
      "properties": {
        "hours": [
          {
            "startTime": "2024-06-11T12:00:00+0000",
            "precip": 0,
            "precip_probability": null,
            "precip_type": "rain",
            "source": "observation"
          },
          {
            "startTime": "2024-06-11T13:00:00+0000",
            "precip": 2.5,
            "precip_probability": null,
            "precip_type": "rain",
            "source": "observation"
          },
          {
            "startTime": "2024-06-12T12:00:00+0000",
            "precip": 1.2,
            "precip_probability": 25,
            "precip_type": "rain",
            "source": "forecast"
          },
          {
            "startTime": "2024-12-04T12:00:00+0000",
            "precip": 0.8,
            "precip_probability": null,
            "precip_type": "snow",
            "source": "observation"
          }
        ],
        "timeZoneId": "GMT"
      }
    }
  ]
}

json

application/json

Minutely Precipitation Rate

GET

https://api.precip.ai

/api/v1/minutely

Returns 1-minute precipitation rate for the given time range and location(s). Historical minutes come from radar analysis available from 2026-01-01). Recent gaps and the next 60 minutes are filled from the Precip AI nowcast interpolated to minute timesteps. Each minute includes instantaneous rate (mm/h), precipitation type joined from hourly analysis/forecast, and a source of observation, nowcast, or forecast. Default window is now-1h to now+1h. Maximum span is 7 days.

Minutely Precipitation Rate › query Parameters

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

start

string

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S, or relative now-1h. Snapped to the UTC minute. Defaults to now-1h when both start and end are omitted.

Example: now-1h

end

string

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S, or relative now+1h. Snapped to the UTC minute. Defaults to now+1h when both start and end are omitted. Maximum end - start is 7 days.

Example: now+1h

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

units

string · enum

Display system: metric (mm/h, default) or imperial (in/h)

Enum values:

metric

imperial

Default: metric

Minutely Precipitation Rate › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Minutely Precipitation Rate › Responses

Minutely precipitation rate successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/minutely

curl --request GET \
  --url 'https://api.precip.ai/api/v1/minutely?longitude=-122.42616&latitude=37.75750' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.42616,
          37.7575
        ]
      },
      "properties": {
        "minutes": [
          {
            "startTime": "2026-09-19T19:45:00+0000",
            "precip_rate": 1.23,
            "precip_type": "rain",
            "source": "observation"
          },
          {
            "startTime": "2026-09-19T20:10:00+0000",
            "precip_rate": 0.4,
            "precip_type": "rain",
            "source": "nowcast"
          },
          {
            "startTime": "2026-09-19T20:45:00+0000",
            "precip_rate": 2.1,
            "precip_type": "rain",
            "source": "forecast"
          }
        ],
        "timeZoneId": "America/Chicago",
        "unit": "mm/h"
      }
    }
  ]
}

json

application/json

Last N Hours Precipitation Data

GET

https://api.precip.ai

/api/v1/last-{hours}

Total precipitation in the last N hours for the given location(s). Use 12, 24, 48, or 168 (7 days) in the path.

Last N Hours Precipitation Data › path Parameters

hours

string · enum · required

Number of hours: 12, 24, 48, or 168 (7 days).

Enum values:

168

Example: 48

Last N Hours Precipitation Data › query Parameters

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Last N Hours Precipitation Data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Last N Hours Precipitation Data › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Recent Rain Event

GET

https://api.precip.ai

/api/v1/recent-rain

Returns detailed information about the most recent precipitation event for the given location(s), including total amounts, precipitation type (rain/snow), timing, and how long ago it occurred.

Recent Rain Event › query Parameters

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Recent Rain Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Recent Rain Event › Responses

Recent rain event data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Forecast Soil Data

Daily Precipitation Data

GET

https://api.precip.ai

/api/v1/daily

Daily Precipitation Data › query Parameters

start

string · required

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

Example: 2024-01-04

Default: 2024-01-04

end

string · required

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

Example: 2024-02-04

Default: 2024-02-04

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Daily Precipitation Data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Daily Precipitation Data › Responses

Daily precipitation data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Hourly Precipitation Data

GET

https://api.precip.ai

/api/v1/hourly

Hourly Precipitation Data › query Parameters

start

string · required

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

Example: 2024-01-04

Default: 2024-01-04

end

string · required

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

Example: 2024-02-04

Default: 2024-02-04

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Hourly Precipitation Data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Hourly Precipitation Data › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Minutely Precipitation Rate

GET

https://api.precip.ai

/api/v1/minutely

Minutely Precipitation Rate › query Parameters

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

start

string

ISO 8601 date %Y-%m-%d or datetime %Y-%m-%dT%H:%M:%S, or relative now-1h. Snapped to the UTC minute. Defaults to now-1h when both start and end are omitted.

Example: now-1h

end

string

Example: now+1h

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

units

string · enum

Display system: metric (mm/h, default) or imperial (in/h)

Enum values:

metric

imperial

Default: metric

Minutely Precipitation Rate › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Minutely Precipitation Rate › Responses

Minutely precipitation rate successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Last N Hours Precipitation Data

GET

https://api.precip.ai

/api/v1/last-{hours}

Total precipitation in the last N hours for the given location(s). Use 12, 24, 48, or 168 (7 days) in the path.

Last N Hours Precipitation Data › path Parameters

hours

string · enum · required

Number of hours: 12, 24, 48, or 168 (7 days).

Enum values:

168

Example: 48

Last N Hours Precipitation Data › query Parameters

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Last N Hours Precipitation Data › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Last N Hours Precipitation Data › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

Recent Rain Event

GET

https://api.precip.ai

/api/v1/recent-rain

Returns detailed information about the most recent precipitation event for the given location(s), including total amounts, precipitation type (rain/snow), timing, and how long ago it occurred.

Recent Rain Event › query Parameters

longitude

string · required

Longitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: -122.42616

Default: -122.42616

latitude

string · required

Latitude (WGS84). Personal API: one value. Commercial keys may pass a comma-separated list.

Example: 37.75750

Default: 37.75750

timeZoneId

string

IANA timezone identifier e.g. America/Chicago

Default: America/Chicago

format

string · enum

Output format: geojson, json or csv

Enum values:

geojson

json

csv

Default: json

Recent Rain Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Recent Rain Event › Responses

Recent rain event data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required