List Tokens
curl --request GET \
--url https://client-backend.oktivo.com/api/v1/crm/tokens \
--header 'Authorization: Bearer <token>'import requests
url = "https://client-backend.oktivo.com/api/v1/crm/tokens"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://client-backend.oktivo.com/api/v1/crm/tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://client-backend.oktivo.com/api/v1/crm/tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://client-backend.oktivo.com/api/v1/crm/tokens"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://client-backend.oktivo.com/api/v1/crm/tokens")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://client-backend.oktivo.com/api/v1/crm/tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"tokenId": "tok_abc123def456",
"name": "salesforce-integration",
"prefix": "okt_a1b2",
"expiresAt": "2025-04-15T00:00:00.000Z",
"lastUsedAt": "2025-01-14T08:30:00.000Z",
"createdAt": "2025-01-15T00:00:00.000Z"
},
{
"tokenId": "tok_xyz789ghi012",
"name": "hubspot-staging",
"prefix": "okt_x7y8",
"expiresAt": "2025-06-01T00:00:00.000Z",
"lastUsedAt": null,
"createdAt": "2025-01-10T12:00:00.000Z"
}
]
}
Authentication
List Tokens
List all active (non-deleted) API tokens.
GET
/
api
/
v1
/
crm
/
tokens
List Tokens
curl --request GET \
--url https://client-backend.oktivo.com/api/v1/crm/tokens \
--header 'Authorization: Bearer <token>'import requests
url = "https://client-backend.oktivo.com/api/v1/crm/tokens"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://client-backend.oktivo.com/api/v1/crm/tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://client-backend.oktivo.com/api/v1/crm/tokens",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://client-backend.oktivo.com/api/v1/crm/tokens"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://client-backend.oktivo.com/api/v1/crm/tokens")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://client-backend.oktivo.com/api/v1/crm/tokens")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"tokenId": "tok_abc123def456",
"name": "salesforce-integration",
"prefix": "okt_a1b2",
"expiresAt": "2025-04-15T00:00:00.000Z",
"lastUsedAt": "2025-01-14T08:30:00.000Z",
"createdAt": "2025-01-15T00:00:00.000Z"
},
{
"tokenId": "tok_xyz789ghi012",
"name": "hubspot-staging",
"prefix": "okt_x7y8",
"expiresAt": "2025-06-01T00:00:00.000Z",
"lastUsedAt": null,
"createdAt": "2025-01-10T12:00:00.000Z"
}
]
}
Response
Returns an array of active tokens for the authenticated user. The plaintext token value is never included in list responses.boolean
Indicates if the request was successful.
array
Array of token objects.
Show token object properties
Show token object properties
string
Unique identifier for the token.
string
The descriptive name given to the token.
string
First 8 characters of the token for identification (e.g.,
okt_a1b2).string
ISO 8601 timestamp of when the token expires.
string | null
ISO 8601 timestamp of the last time this token was used, or
null if never used.string
ISO 8601 timestamp of when the token was created.
{
"success": true,
"data": [
{
"tokenId": "tok_abc123def456",
"name": "salesforce-integration",
"prefix": "okt_a1b2",
"expiresAt": "2025-04-15T00:00:00.000Z",
"lastUsedAt": "2025-01-14T08:30:00.000Z",
"createdAt": "2025-01-15T00:00:00.000Z"
},
{
"tokenId": "tok_xyz789ghi012",
"name": "hubspot-staging",
"prefix": "okt_x7y8",
"expiresAt": "2025-06-01T00:00:00.000Z",
"lastUsedAt": null,
"createdAt": "2025-01-10T12:00:00.000Z"
}
]
}
This endpoint requires JWT authentication. Deleted tokens are not included in the response.