List event logs
Beta. This endpoint is available under /v0/event-logs while we
collect feedback. It may change before stabilizing at /v1.
Returns audit events for your organization, newest first. Admin role required.
Each row carries a data payload whose shape depends on type (e.g.
integrations.create returns an integration snapshot;
sessions.update returns a field-diff). Treat unknown type values
gracefully — new values may be added over time.
Rate-limited to 100 requests per minute.
curl --request GET \
--url https://api.traversal.com/v0/event-logs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.traversal.com/v0/event-logs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.traversal.com/v0/event-logs', 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://api.traversal.com/v0/event-logs",
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://api.traversal.com/v0/event-logs"
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://api.traversal.com/v0/event-logs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.traversal.com/v0/event-logs")
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{
"event_logs": [
{
"id": 482913,
"time": "2026-05-27T14:31:02Z",
"type": "integrations.create",
"user_id": "a9c2e3b0-7d6f-4a3c-9b21-e1a8d4d56f8e",
"user_email": "alice@acme.com",
"data": {
"id": "int-prod-datadog",
"name": "prod-datadog",
"type": "datadog",
"created_by_user_id": "a9c2e3b0-7d6f-4a3c-9b21-e1a8d4d56f8e",
"created_by_user_email": "alice@acme.com"
}
}
],
"count": 123,
"total": 123,
"prev": 123,
"next": 123
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}Authorizations
Bearer token in the Authorization header — for example,
Authorization: Bearer YOUR_API_KEY. Personal keys act as their owner;
the Sessions API also accepts organization-owned service-account keys.
Knowledge Files endpoints currently require a personal key.
Query Parameters
Filter by event type, e.g. integrations.update.
Dotted <resource>.<action> identifier for an event. New values may
be added over time — clients should treat unknown values gracefully.
integrations.create, integrations.update, integrations.delete, api_keys.create, api_keys.delete, users.invite_sent, users.invite_accepted, users.role_granted, users.archive, auth.login, auth.logout, sessions.create, sessions.update, sessions.delete Inclusive lower bound on the event timestamp (ISO-8601 UTC).
Exclusive upper bound on the event timestamp (ISO-8601 UTC). Must be greater than start_time if both are set.
Page number (1-indexed).
x >= 1Number of events per page (max 100).
1 <= x <= 100Response
A page of event logs.
Events on the current page, ordered newest-first by id.
Show child attributes
Show child attributes
Number of events on this page.
Total events matching the filters across all pages.
Previous page number. null if first page.
Next page number. null if last page.
curl --request GET \
--url https://api.traversal.com/v0/event-logs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.traversal.com/v0/event-logs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.traversal.com/v0/event-logs', 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://api.traversal.com/v0/event-logs",
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://api.traversal.com/v0/event-logs"
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://api.traversal.com/v0/event-logs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.traversal.com/v0/event-logs")
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{
"event_logs": [
{
"id": 482913,
"time": "2026-05-27T14:31:02Z",
"type": "integrations.create",
"user_id": "a9c2e3b0-7d6f-4a3c-9b21-e1a8d4d56f8e",
"user_email": "alice@acme.com",
"data": {
"id": "int-prod-datadog",
"name": "prod-datadog",
"type": "datadog",
"created_by_user_id": "a9c2e3b0-7d6f-4a3c-9b21-e1a8d4d56f8e",
"created_by_user_email": "alice@acme.com"
}
}
],
"count": 123,
"total": 123,
"prev": 123,
"next": 123
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}{
"error": {
"code": "conflict",
"message": "<string>",
"retry_after": 123
}
}