The Kondado API allows you to programmatically connect our platform to your analytics stack, improving the integration across all stages of your data ecosystem.

Base URL

Unless the documentation of a specific endpoint states otherwise, all requests must be made using the following base URL:

https://k2.kondado.com.br

Authentication

Before getting started with our API, you will need to generate access tokens according to this tutorial.

The generated tokens inherit the permissions of the user who created them and are used to authenticate your requests in a secure way, allowing easy revocation without requiring you to change your password.

A token is composed of two components:

• key: token identifier
• token: the token "password"

Once you have both the key and the token, you must pass them as parameters in your requests as follows:

• key: token key
• token: token value

Example of an authenticated URL

https://k2.kondado.com.br/{endpoint}?key=tokenkey&token=yourtokenhere

Request Limits

The API has two rate limits, applied per IP and per key:

• 1 request per second
• 20 requests per minute

When these limits are exceeded, the following error will be returned (with HTTP status code 200):

{
    "success": false,
    "error": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again in 60 seconds."
}