FieldClimate API data constraints, data access limits and pricing

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.

The rules and constraints mentioned in here also apply to our other endpoints which either accept device-id or date or both parameters, listed in our current documentation (link below).

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)

Pricing

For information about pricing, please, e-mail subscriptions@metos.global.

Documentation

Click Here to the API documentation and examples