Authentication

The CIM API uses OAuth 2.0 as the means of authorization for individual requests using the Refresh Token Grant Type. To get a Refresh Token, please contact CIM support at support@cim.io.

Once you have your Refresh Token, you can exchange it for an Access Token via this POST endpoint. Replace the refresh_token in the FORM DATA below with the Refresh Token you obtained from CIM Support.

Once you've obtained an Access Token, it needs to be passed in the Authorization header on all individual requests to the CIM API. For example, Authorization: Bearer b7f8f791...f26e554d.

📘
Access Token Expiry

Please note that Access Tokens expire after 1 day, at which point you would need to use your Refresh Token to generate a new Access Token to use. See our example use cases of how you can programmatically generate a new Access Token using your Refresh Token.

xxxxxxxxxx
curl --request POST \
     --url https://login.cimenviro.com/auth/realms/cimenviro/protocol/openid-connect/token \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data grant_type=refresh_token \
     --data client_id=api-external \
     --data refresh_token=YOUR_REFRESH_TOKEN

📘Access Token Expiry

200200

400400

📘
Access Token Expiry