Core
timestamp__lte
timestamp__gte
identity
data_source
actor
location
labels
The pagination cursor value.
Number of results to return per page.
UUID of filter to apply to results.
GET /core/activity/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"timestamp": "2026-01-01T00:00:00.000Z",
"identity": "123e4567-e89b-12d3-a456-426614174000",
"location": "123e4567-e89b-12d3-a456-426614174000",
"data_source": "123e4567-e89b-12d3-a456-426614174000",
"event_type": "123e4567-e89b-12d3-a456-426614174000",
"integration_unique": "text"
}
]
}View to return first and last activity timestamps.
GET /core/activity/first_last/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"first": {
"timestamp": "2026-01-01T00:00:00.000Z"
},
"last": {
"timestamp": "2026-01-01T00:00:00.000Z"
}
}Provides a view returning a list of actors with activity count intervals corresponding to the time range and interval count requested.
timestamp__lte
timestamp__gte
interval_count
A page number within the paginated result set.
Number of results to return per page.
UUID of filter to apply to results.
GET /core/activity/statistics/actor/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"links": {
"next": "https://example.com",
"previous": "https://example.com"
},
"interval_duration": 1,
"results": [
{
"actor": "123e4567-e89b-12d3-a456-426614174000",
"counts": [
{
"timestamp": "2026-01-01T00:00:00.000Z",
"count": 1
}
]
}
]
}Provides a view returning overall activity stats for an organization or datasource. Used primarily for populated brush timeline data.
timestamp__lte
timestamp__gte
interval_count
A page number within the paginated result set.
Number of results to return per page.
GET /core/activity/statistics/combined/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"links": {
"next": "https://example.com",
"previous": "https://example.com"
},
"interval_duration": 1,
"results": [
{
"timestamp": "2026-01-01T00:00:00.000Z",
"count": 1
}
]
}Provides a view of activity statistics aggreagted by datasource.
timestamp__lte
timestamp__gte
interval_count
A page number within the paginated result set.
Number of results to return per page.
GET /core/activity/statistics/datasource/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"links": {
"next": "https://example.com",
"previous": "https://example.com"
},
"interval_duration": 1,
"results": [
{
"data_source": "123e4567-e89b-12d3-a456-426614174000",
"counts": [
{
"timestamp": "2026-01-01T00:00:00.000Z",
"count": 1
}
]
}
]
}View for returning activity counts by label, bucketed by data source.
timestamp__lte
timestamp__gte
data_source
interval_count
A page number within the paginated result set.
Number of results to return per page.
UUID of filter to apply to results.
GET /core/activity/statistics/label/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"links": {
"next": "https://example.com",
"previous": "https://example.com"
},
"interval_duration": 1,
"results": [
{
"labels": [
{
"label": "123e4567-e89b-12d3-a456-426614174000",
"counts": [
{
"timestamp": "2026-01-01T00:00:00.000Z",
"count": 1
}
],
"total_count": 1
}
],
"data_source": "123e4567-e89b-12d3-a456-426614174000"
}
]
}Provides a view returning a list of locations with activity count intervals corresponding to the time range and interval count requested.
timestamp__lte
timestamp__gte
interval_count
A page number within the paginated result set.
Number of results to return per page.
GET /core/activity/statistics/location/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"links": {
"next": "https://example.com",
"previous": "https://example.com"
},
"interval_duration": 1,
"results": [
{
"location": "123e4567-e89b-12d3-a456-426614174000",
"counts": [
{
"timestamp": "2026-01-01T00:00:00.000Z",
"count": 1
}
]
}
]
}GET /core/activity/{uuid}/raw/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"activity_uuid": "123e4567-e89b-12d3-a456-426614174000",
"json_data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}GET /core/activity/{uuid}/raw/details/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"details": [
{
"field_name": "text",
"value": "text"
}
]
}Which field to use when ordering the results.
The pagination cursor value.
Number of results to return per page.
Search string
Filter by identity UUIDs (comma-separated)
GET /core/actors/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"given_name": "text",
"family_name": "text",
"organization": "123e4567-e89b-12d3-a456-426614174000",
"identities": [
"123e4567-e89b-12d3-a456-426614174000"
]
}
]
}GET /core/actors/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"given_name": "text",
"family_name": "text",
"organization": "123e4567-e89b-12d3-a456-426614174000",
"identities": [
"123e4567-e89b-12d3-a456-426614174000"
]
}A search term.
A page number within the paginated result set.
Number of results to return per page.
Return only event types with at least this many activities.
GET /core/event-type/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"integration_type": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"discard": true,
"linked_tags": [
{
"label": "text",
"scope": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": 1
}
]
}
]
}POST /core/event-type/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 102
{
"integration_type": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"discard": true
}{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"integration_type": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"discard": true,
"linked_tags": [
{
"label": "text",
"scope": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": 1
}
]
}Filter by event type UUIDs (comma-separated)
Filter by event type UUIDs (comma-separated, alternative to event_types)
A page number within the paginated result set.
GET /core/event-type/descriptions/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"event_type_uuid": "123e4567-e89b-12d3-a456-426614174000",
"description": "text"
}
]
}GET Endpoint for EventTypeDetails
GET /core/event-type/{event_type__uuid}/details/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"description": "text"
}GET /core/event-type/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"integration_type": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"slug": "text",
"discard": true,
"linked_tags": [
{
"label": "text",
"scope": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": 1
}
]
}A page number within the paginated result set.
Number of results to return per page.
GET /core/filters/builtin/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"highlight": [
"text"
],
"is_template": true
}
]
}trueGET /core/filters/builtin/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"highlight": [
"text"
],
"is_template": true
}A page number within the paginated result set.
Number of results to return per page.
Specify what types of filters to fetch:
exclude_temporary: Fetch filters only manually saved filtersonly_temporary: Fetch filters only temporary filtersall: Fetch all types of filters
GET /core/filters/user/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"user": "123e4567-e89b-12d3-a456-426614174000",
"last_user_editor": "123e4567-e89b-12d3-a456-426614174000",
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"visibility": "user",
"is_temporary": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
]
}POST /core/filters/user/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 567
{
"analyst": 1,
"last_analyst_editor": 1,
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"organization": 1,
"visibility": "user",
"is_temporary": true
}{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"user": "123e4567-e89b-12d3-a456-426614174000",
"last_user_editor": "123e4567-e89b-12d3-a456-426614174000",
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"visibility": "user",
"is_temporary": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}GET /core/filters/user/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"user": "123e4567-e89b-12d3-a456-426614174000",
"last_user_editor": "123e4567-e89b-12d3-a456-426614174000",
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"visibility": "user",
"is_temporary": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}PUT /core/filters/user/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 567
{
"analyst": 1,
"last_analyst_editor": 1,
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"organization": 1,
"visibility": "user",
"is_temporary": true
}{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"user": "123e4567-e89b-12d3-a456-426614174000",
"last_user_editor": "123e4567-e89b-12d3-a456-426614174000",
"analyst": 1,
"last_analyst_editor": 1,
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"organization": 1,
"visibility": "user",
"is_temporary": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}No content
DELETE /core/filters/user/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
No content
PATCH /core/filters/user/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 494
{
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"visibility": "user"
}{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"user": "123e4567-e89b-12d3-a456-426614174000",
"last_user_editor": "123e4567-e89b-12d3-a456-426614174000",
"filter_json": {
"filter_name": "text",
"filter_icon": "text",
"filter_description": "text",
"actors": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"data_sources": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"event_types": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"locations": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"labels": {
"Application": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Context": {
"ANY_ADDITIONAL_PROPERTY": "with"
},
"Access": {
"ANY_ADDITIONAL_PROPERTY": "with"
}
},
"date_range": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"visibility": "user",
"is_temporary": true,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}uuid
Filter by identity UUIDs (comma-separated)
A search term.
A page number within the paginated result set.
Number of results to return per page.
GET /core/identity/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"given_name": "text",
"family_name": "text",
"identifier": "name@gmail.com",
"data_source": 1
}
]
}GET /core/identity/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"id": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"given_name": "text",
"family_name": "text",
"identifier": "name@gmail.com",
"data_source": 1
}uuid
Filter by location UUIDs (comma-separated)
Filter by location UUIDs (comma-separated, alternative to uuids param)
A search term.
A page number within the paginated result set.
Number of results to return per page.
GET /core/locations/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"ip_address": "text",
"city": "text",
"region": "text",
"country": "text",
"country_code": "text",
"latitude": 1,
"longitude": 1,
"category": "Unknown"
}
]
}GET /core/locations/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"ip_address": "text",
"city": "text",
"region": "text",
"country": "text",
"country_code": "text",
"latitude": 1,
"longitude": 1,
"category": "Unknown"
}PATCH /core/locations/{uuid}/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22
{
"category": "Unknown"
}{
"category": "Unknown"
}A page number within the paginated result set.
GET /core/queries/user/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"count": 1,
"next": "https://example.com",
"previous": "https://example.com",
"results": [
{
"filter": "text",
"filter_json": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"is_temporary": true,
"executed_at": "2026-01-01T00:00:00.000Z"
}
]
}A view for providing the current build version.
GET /core/version/ HTTP/1.1
Host: api.turngate.io/
Authorization: YOUR_API_KEY
Accept: */*
{
"version": "text"
}Last updated

