Skip to main content
To securely access and interact with Kua.ai’s API, you need to authenticate your account and get the API AccessToken. The token is used to authenticate your requests to the API.

​
Get API AccessToken

To get the API AccessToken, you need to authenticate your account using the Authentication API:

Authenticate API

View the Authentication API documentation and code example
 Code example to get the API AccessToken:

​
cURL

curl -X POST "https://api.kua.ai/core/api/v2/accounts/sessions/email" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "password"
    }'

​
Python

import requests

url = "https://api.kua.ai/core/api/v2/accounts/sessions/email"

headers = {
    "Content-Type": "application/json"
}

payload = {
    "email": "[email protected]",
    "password": "password"
}

response = requests.post(url, headers=headers, json=payload)

​
JavaScript

const url = "https://api.kua.ai/core/api/v2/accounts/sessions/email";
const headers = {
    "Content-Type": "application/json"
};
const body = JSON.stringify({
    email: "[email protected]",
    password: "password"
});

fetch(url, { method: 'POST', headers: headers, body: body })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
Example Output: 
{
  "accessToken": "<string>",
  "tokenType": "<string>",
  "tokenFormat": "<string>",
  "expiresIn": 123
}

​
Using the API AccessToken

All API endpoints are authenticated using Bearer tokens, you must include the API Access Token int the request headers as an Authorization Bearer token. Below are examples of how to include the API Key in requests using cURL, Python and JavaScript.

​
cURL

curl -X GET "https://api.kua.ai/core/api/v2/accounts" \
-H "Authorization: Bearer <AccessToken>"

​
Python

import requests

# Replace <AccessToken> with your actual access token
access_token = "<AccessToken>"

url = "https://api.kua.ai/core/api/v2/accounts"
headers = {
    "Authorization": f"Bearer {access_token}"
}

response = requests.get(url, headers=headers)

​
JavaScript

const url = "https://api.kua.ai/core/api/v2/accounts";
const accessToken = "<AccessToken>"; // Replace <AccessToken> with your actual access token

const headers = {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${accessToken}`
};

fetch(url, { method: 'GET', headers: headers })
    .then(response => response.json())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));