EMS Legacy: Obtain Access Token

To connect to the EMS API, you need to include a TID OAuth authentication token in the API request header.

A valid token is required. If a token is expired, you will not be able to connect to EMS. Ensure you are sending the correct, active token with your API calls.

To generate an access token:

1. From API Cloud, under My Applications, navigate to the EMS application.

2. Base 64 encode your access keys:

   Consumer Key:Consumer Secret

3. To get an access token, use one of the following endpoints:

   • STG:

     POST https://identity-stg.trimble.com/token

   • PROD:

     POST https://identity.trimble.com/token

4. In the header include:

   • Key: Authorization
   • Value: Basic {base 64 string}
   • Content-Type: application/x-www-form-urlencoded

5. In the body include:

   grant_type=client_credentials

The JSON response will include the access token for the EMS API:

Example:

{
    "access_token": "k0fyy384f2009f69xxx24e288c5fac69",
    "token_type": "Bearer",
    "expires_in": 48188
}

For detailed information on generating a Trimble Identity access token, see the API Cloud documentation.