Skip to main content
Agricultural machinery
Digital Solutions
Service & Parts
Experience
Careers
Press
About CLAAS

Point Data | API-Scope

Retrieval of Telemetry and Agronomic Machine Data.

Enable documentation of connected machines by utilizing telemetry data. The Point Data API scope allows access to data from connected machines. The data is automatically recorded—independent of any manual inputs by the operator.

 

As a CLAAS connect API partner, and with the customer's consent, the Point Data API scope can be used to retrieve telemetry data, including machine positions and measurement values.

The API-Scope

 

The API uses REST services, OAuth2, and employs a JSON data format.

 

Each data point in the received JSON format provides information relating to a single GPS point and timestamp. Due to the large amounts of data a machine generates over time, the API supports queries with the following restrictions and responses:

 

  • Short time period – within an interval from 5 minutes up to 1 hour: the values for this request are returned directly in the call response.
  • Long time period – within an interval from 1 hour up to 31 days: the values are collected in the background and made available as a compressed archive for retrieval.
     

 

 

The main use cases are:

 

  • Requesting a machine list of a customer organization.
  • Retrieving telemetry data for performance documentation of the machine.
  • Retrieving telemetry data for agronomic documentation of the machine.
  • Requesting data for a specific machine and dataset using a time period.
  • Requesting data for a specific machine and dataset using a GPS filter.
  • Requesting data for a specific machine and dataset using both a time period and a GPS filter.


 

 

Contact

 

To use the services, third-party providers must be official partners of CLAAS, as our API scopes are restrictedly accessible and not completely public. To become an official partner, you can contact us here.