FieldClimate API - Data Constraints & Data Access Limits

Data Constraints & Data Access Limits Based on the Chosen Tier

Below you will find information on how to interact with our key API endpoints, along with possible error messages you may encounter and the corresponding constraints and data access limits.

API Access Packages and Tiers

API Calls

Tier 1: Up to 48 requests per station/day

Tier 2: Up to 500 requests per station/day

Tier 3: Up to 1500 requests per station/day

Data Access Limits

Tier 1: Last 30 days

Tier 2: Last 365 days

Tier 3: Full historical data (10 years)

Data Access Limits per API Call

Raw data: Last 7 days

Hourly/Daily Aggregation: Last 30 days

Monthly Aggregation: As per tier

Base URL

https://api.fieldclimate.com/v2

Placeholders

`{deviceId}`: Replace this with the unique identifier of the device.
`{startTime}`: Replace this with the start time in Unix timestamp format.
`{endTime}`: Replace this with the end time in Unix timestamp format.
`{interval}`: Replace this with the desired interval duration e.g., (1,2,3 etc).

Accessing Historical Data

Raw Data

Endpoint: `/data/{deviceId}/raw/from/{startTime}/to/{endTime}`

Error Code: 403

Message: `Search history access is limited to {data-access-limit} days from today`

Hourly Data

Endpoint: `/data/{deviceId}/raw/from/{startTime}/to/{endTime}`

Error Code: 403

Message: `Search history access is limited to {data-access-limit} days from today`

Daily Data

Endpoint: `/data/{deviceId}/daily/from/{startTime}/to/{endTime}`

Error Code: 403

Message: `Search history access is limited to {data-access-limit} days from today`

Monthly Data

Endpoint: `/data/{deviceId}/monthly/from/{startTime}/to/{endTime}`

Error Code: 403

Message: `Search history access is limited to {data-access-limit} days from today`

Accessing Recent Data

Raw Data

Endpoint: `/data/{deviceId}/raw/last/{interval}`

Error Code: 403

Message: `The interval limit for the data group 'raw' is 7 days.`

Data Access Limit: Last 7 days

Hourly Data

Endpoint: `/data/{deviceId}/hourly/last/{interval}`

Error Code: 403

Message: `The interval limit for the data group 'hourly' is 30 days.`

Data Access Limit: Last 30 days

Daily Data

Endpoint: `/data/{deviceId}/daily/last/{interval}`

Error Code: 403

Message: `The interval limit for the data group 'daily' is 30 days.`

Data Access Limit: Last 30 days

Monthly Data

Endpoint: `/data/{deviceId}/monthly/last/{interval}`

Error Code: 403

Message: `The interval limit for the data group 'monthly' is 3650 days.`

Data Access Limit: As per tier (Tier 1: Last 30 days, Tier 2: Last 365 days, Tier 3: Full historical data - 10 Years)

The rules and constraints mentioned above also apply to our other endpoints which either accept device-id or date or both parameters, listed in our current documentation available at https://api.fieldclimate.com/v2/docs/.

If you have any questions or need additional help, please submit a ticket to our Support team at METOS® support center, informing:

- Username or HMAC Public Key or Oauth 2.0 Client ID.
- Device ID and affected time period.
- Full request details (method, URL, payload).
- Full response details (status code, message, result).
- Screenshots, if available.