Precipitation & Weather Data API

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

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 Precipitation Data › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

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%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 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

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 Precipitation Data › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

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%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

Last 48 Hours Precipitation Data

GET

https://api.precip.ai

/api/v1/last-48

Total precipitation in the last 48 hours for the given location(s).

Last 48 Hours Precipitation Data › query Parameters

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

Last 48 Hours Precipitation Data › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

Last 48 Hours Precipitation Data › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/last-48

curl --request GET \
  --url 'https://api.precip.ai/api/v1/last-48?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": {
        "precip": 0,
        "endTime": "endTime"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

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. A rain event is defined as more than 1/10 inch (2.5mm) of precipitation with less than a 24-hour gap between occurrences.

Recent Rain Event › query Parameters

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

Recent Rain Event › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

Recent Rain Event › Responses

Recent rain event data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

GET/api/v1/recent-rain

curl --request GET \
  --url 'https://api.precip.ai/api/v1/recent-rain?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": {
        "precip": 0,
        "precip_type": "rain",
        "slr": 0,
        "snow": 0,
        "rain": 0,
        "endTime": "2024-08-25T15:00:00Z",
        "ago": "ago",
        "details": "details"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          0
        ]
      }
    }
  ]
}

json

application/json

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

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 Precipitation Data › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

Daily Precipitation Data › Responses

Daily precipitation data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

curl --request GET \ --url 'https://api.precip.ai/api/v1/daily?start=2024-01-04&end=2024-02-04&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 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

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 Precipitation Data › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

Hourly Precipitation Data › Responses

Successful Response

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

curl --request GET \ --url 'https://api.precip.ai/api/v1/hourly?start=2024-01-04&end=2024-02-04&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 ] } } ] }

Last 48 Hours Precipitation Data

GET

https://api.precip.ai

/api/v1/last-48

Total precipitation in the last 48 hours for the given location(s).

Last 48 Hours Precipitation Data › query Parameters

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

Last 48 Hours Precipitation Data › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

Last 48 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

Recent Rain Event › query Parameters

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

Recent Rain Event › Headers

Authorization

string · required

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

Example: Bearer YOUR_API_KEY

Recent Rain Event › Responses

Recent rain event data successfully retrieved

type

string · enum · required

Enum values:

FeatureCollection

object[] · required