Kaa REST API

The Kaa platform exposes a REST API that can be used to manage and interact with Kaa entities. For example, using the REST API, you can create or delete an endpoint, retrieve collected data from it, suspend its token, and more. Most request and response bodies are in JSON format.

Kaa Version

Currently, there are two Kaa platforms: Kaa Cloud and Kaa Next. These two versions use different processes for generating an access token.

You can determine which version you are using by logging in to your Kaa Console and checking the domain:

• If the domain is cloud.kaaiot.com, you are using Kaa Cloud.
• If the domain is next.kaaiot.com, you are using Kaa Next.

Base URL

All API documentation examples use the Kaa Cloud base URL (https://cloud.kaaiot.com) or the Kaa Next base URL (https://next.kaaiot.com), depending on the Kaa Version you are using.

Each REST API endpoint is backed by a particular microservice; that’s why each API path starts with the microservice’s short name, e.g., /re, /epr, /etps, etc. Then short name is followed by the static /api part and API version - usually /v1.

Example of the /endpoints URL for kaa cloud is https://cloud.kaaiot.com/epr/api/v1/endpoints. Example of the /endpoints URL for kaa next is https://next.kaaiot.com/epr/api/v1/endpoints.

How to Retrieve a REST API Access Token

• Kaa Cloud: See Authentication.
• Kaa Next: See Authentication.