Pairtree Pipes Sandbox (v1.0)
Download OpenAPI specification:Download
API Functions Manual for Pairtree Pipes Sandbox.
This manual will be updated from time to time so please save the link rather than the document.
SBX Historic Weather
This function can be used to obtain the historic weather for the specified org/location.
Output can be requested as an average (per day of the year) or raw data.
Default output produces an average for each day of the year using 100 years of data at the specified org and location(s).
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> dafault is null for all locations in that org |
| date_from | any <text> The date you want the history from, defaults to 100 years before today. |
| date_to | any <text> The date you want the forecast to, defaults to today. |
| output_average | any <bool> defaults to true. |
Responses
Response samples
- 200
{- "loc_id": "string",
- "loc_name": "string",
- "rainfall": "string",
- "temp_max": "string",
- "temp_min": "string",
- "data_date": "string",
- "evaporation": "string",
- "output_type": "string"
}SBX Tank Sensor
This function can be used to obtain the tank sensor readings for an org, location or individual device.
Default output produces 30 days of data for all sensors at the specified org.
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> Location Id being queried, default is null for all locations in that org |
| device_id | any <int4> The Device ID being queried, default is null which returns all devices at that location/org |
| date_from | any <text> The date you want the history from, defaults to 100 years before today, format of 'yyyy-mm-dd' e.g. '2023-01-01'. |
| date_to | any <text> The date you want the history to, defaults to today, format of 'yyyy-mm-dd' e.g. '2023-01-01'. |
Responses
Response samples
- 200
{- "value": "string",
- "dev_id": "string",
- "loc_id": "string",
- "dev_name": "string",
- "loc_name": "string",
- "data_date": "string"
}SBX Weather Forecast
This function can be used to obtain the weather forecast for the specified org/location
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> Location Id being queried |
| data_supplier | any <text> Name of the supplier being queried |
| date_from | any <text> The date you want the forecast from, defaults to Today (midnight) |
| date_to | any <text> The date you want the forecast to, defaults to 7 days from Today (23:59:59) |
Responses
Response samples
- 200
{- "uom": "string",
- "value": "string",
- "metric": "string",
- "event_time": "string"
}SBX Get GeoJSON
This function can be used to obtain all geoJSON's for an org, or for a specific location with an optional parameter.
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> this is an optional field |
Responses
Response samples
- 200
{- "geojson": "string",
- "location_id": "string",
- "location_name": "string"
}SBX Tank Sensor
This function can be used to obtain the tank sensor readings for an org, location or individual device.
Default output produces 30 days of data for all sensors at the specified org.
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> Location Id being queried, default is null for all locations in that org |
| device_id | any <int4> The Device ID being queried, default is null which returns all devices at that location/org |
| date_from | any <text> The date you want the history from, defaults to 100 years before today, format of 'yyyy-mm-dd hh:mm:ss' e.g. '2023-01-01 00:00:00'. |
| date_to | any <text> The date you want the forecast to, defaults to today at 00:00:00, format of 'yyyy-mm-dd hh:mm:ss' e.g. '2023-01-01 00:00:00'. |
Responses
Response samples
- 200
{- "value": "string",
- "dev_id": "string",
- "loc_id": "string",
- "dev_name": "string",
- "loc_name": "string",
- "data_timestamp": "string"
}SBX Virtual Weather
This function can be used to obtain the latest weather data for the specified device.
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> Location Id being queried |
| data_supplier | any <text> description9 |
Responses
Response samples
- 200
{- "uom": "string",
- "value": "string",
- "metric": "string",
- "last_updated": "string"
}SBX Get Area
This function can be used to obtain the land area of an org by location, paddock name or filter by paddock names. Returns area in hectares.
Authorizations:
query Parameters
| data_org_id required | any <int4> Org Id being queried |
| location_id | any <int4> Location Id being queried |
| show_paddocks | any <bool> 'true' will show areas based on paddock names, false will group by location |
| paddock_name_like | any <text> Returns paddocks where paddock_name is like this entry |
Responses
Response samples
- 200
{- "map_area": "string",
- "location_id": "string",
- "paddock_name": "string",
- "location_name": "string"
}SBX Get Org Information
This function can be used to obtain information about the org_id queried. e.g. https://my.pairtree.co/pairtree/v2/api/function/s_org_v1/execute?data_org_id=231
Authorizations:
query Parameters
| data_org_id | any <int4> Org Id being queried, for sandbox use 231 |
Responses
Response samples
- 200
{ }