API Access and Configuration

Setting Up Your Connection

API Access

Based on your request you will be given access to one or more of the following:

  • Ag Data API - all requestors are given access to this API
  • Ag Telematics API - requestors are given access to this API based on their requirements and approval for their application.
  • Ag Company API - access to the the Company API is based on the requestor already having access to a Company Account.

Grant Type Options

Your application will configured using one of the options below. This will be based on who is accessing the API through your application.

  • Authorization Code Grant

    • Authorization level: User
    • Use Case - This configuration option utilizes user-level authorization. This is applicable when multiple users (i.e. your customers) log into the 3rd party application connected via API (your application) and every user should have access to the different organizations that they individually have access to through different Trimble Ag Software logins.
    • Operation - Allows confidential and public clients to exchange an authorization code for an access token via a trusted back channel.
  • Client Credentials Grant

    • Authorization level: Application
    • Use Case - Applicable when only a single entity (i.e. your business) logs into the 3rd party application connected via API (your application) and every user should have access to the same authorized organizations from Trimble Agriculture.
    • Operation - Allows clients to obtain an access token outside of the context of a user with a secured environment.