Daily Observed Weather

You are here:
< All Topics
image_pdfDownload as PDF

Understanding the recent and long-term daily weather is critical for making in-season decisions. This API opens the weather attributes that matter most to agriculture. Historical access varies based on API subscription. For dates past your account’s limit, use the Norms API to get multi-year averages.

API Request

API Endpoints


GET /v2/weather/fields/{fieldId}/observations
  • The default observations endpoint will return the last 7 days of data for the selected field location.
GET /v2/weather/fields/{fieldId}/observations/{singleDate}
GET /v2/weather/fields/{fieldId}/observations/{startDate},{endDate}
  • Use either a single date or a start and end date to return any number of days of data.
  • When selecting a range of days, by default 10 days will be included on each page of the list.


{fieldId}The ID of the field location for which you want weather.A string
{singleDate}A single date, for which the API will return just one day’s worth of observed weather for the field location. This day must be yesterday or earlier.A date formatted as YYYY-MM-DD
Two dates separated by a comma, implying the start and end date of a range. The API will return data for all the days between those dates (inclusive). Both dates must yesterday or earlier.Dates formatted as YYYY-MM-DD

Query String Parameters

limitThe number of results to include in each response. Used in conjunction with offset to paginate.

Applies only when requesting more than one day.
An integer number up to 10 for all users.
offsetThe number of objects to skip before returning objects. Used in conjunction with limit to paginate. For example, if limit=10 and offset=10, then the API will return the second page of results.

Applies only when requesting more than one day.
An integer up to the total number of results.
sortThis API can sort its results by date, descending or ascending, when this parameter is used and set to date. See Sorting Conventions for more information.

Applies only when requesting more than one day.
propertiesOnly include these properties in the daily data. If not specified, then all properties are included by default. Any properties not specified are always included, and all child properties of a selection are included. Separate multiple choices with a comma. For example if you specify temperatures you will get min, max, and units.

Applies to all endpoints.
unitsBy default, the API will return metric units (e.g., Celsius, millimeters, etc). When set to usa:
-temperatures are returned in Fahrenheit
-precipitation is returned in inches
-wind speed is returned in miles per hour
The API response includes properties that indicate the units for each temperature attribute. This parameter applies to all endpoints.

Request Body


HTTP Headers

Remember to always send your OAuth2 Access Token in the Authorization header (see Authentication). This API doesn’t require any additional headers.

API Response

Response HTTP Status Codes and Headers

This API returns standard HTTP status codes and headers for aWhere APIs. Additionally, when requesting multiple days of data, the API returns a Content-Range header which is another way to know how many results are being shown and the total number of results. It looks like this:

Content-Range: {start}-{end}/{total} fields

Response Body



        ... repeat ... 

Note: When requesting just a single day of data, the response is only a single day’s object, shown here as the first object in the observations array.


dateThe date for which the weather attributes apply. Each day in the requested range is an object in the observations array.
locationThe location the weather is for, including the geolocation and repeating the supplied Field ID.
temperaturesThe daily high and low temperature at the field location, plus a property that describes the temperature units (e.g., “F” for Fahrenheit or “C” for Celsius). You can change the units with the units query string parameter.
precipitationThe amount of rain that fell in this location on this day, with the units (either “mm” or millimeters or “in” for inches). You can change the units with the units query string parameter.
solarThe solar energy received that day. There is a units child property, but its value will always be in Watt hours per square meter (Wh/m^2).
relativeHumidityThe daily high and low relative humidity at the field location. The units are always in percent.
windThe day’s highest wind speed, highest wind speed measured in the morning hours, and average wind speed with the units (either “m/sec” for meters per second, or “mph” for miles per hour) recorded at 10m. You can change the units with the units query string parameter.
{dailySelfLink}The URI you can use to retrieve a specific day’s weather (useful for caching a response).
awhere:fieldThe URI you can use to retrieve the field location information.
{list_self}The URI used to generate the list, which includes any current pagination parameters
{next_page}The URI used to get the next page of results, using the same limit used for this request (default is 10). If there are no more results this property is not included.
{previous_page}The URI used to get the previous page of results, using the same limit used for this request (default is 10). If you’re at the beginning of the list this property is not included.
Was this article helpful?
5 out Of 5 Stars
5 Stars 100%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Table of Contents