Skip to content

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.

  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.