Query raw trace events from engineering data sources
curl --request POST \
--url https://api.getcortexapp.com/api/v1/eng-intel/trace \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"attributes": [
"<string>"
],
"endDate": "2023-11-07T05:31:56Z",
"filters": [
{
"attribute": "<string>",
"predicate": {}
}
],
"limit": 123,
"orderBy": [
{
"attribute": "<string>"
}
],
"source": "<string>",
"startDate": "2023-11-07T05:31:56Z",
"daysOfWeek": [
123
],
"nextPage": "<string>",
"timeAttribute": "<string>"
}
'import requests
url = "https://api.getcortexapp.com/api/v1/eng-intel/trace"
payload = {
"attributes": ["<string>"],
"endDate": "2023-11-07T05:31:56Z",
"filters": [
{
"attribute": "<string>",
"predicate": {}
}
],
"limit": 123,
"orderBy": [{ "attribute": "<string>" }],
"source": "<string>",
"startDate": "2023-11-07T05:31:56Z",
"daysOfWeek": [123],
"nextPage": "<string>",
"timeAttribute": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
attributes: ['<string>'],
endDate: '2023-11-07T05:31:56Z',
filters: [{attribute: '<string>', predicate: {}}],
limit: 123,
orderBy: [{attribute: '<string>'}],
source: '<string>',
startDate: '2023-11-07T05:31:56Z',
daysOfWeek: [123],
nextPage: '<string>',
timeAttribute: '<string>'
})
};
fetch('https://api.getcortexapp.com/api/v1/eng-intel/trace', 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.getcortexapp.com/api/v1/eng-intel/trace",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'attributes' => [
'<string>'
],
'endDate' => '2023-11-07T05:31:56Z',
'filters' => [
[
'attribute' => '<string>',
'predicate' => [
]
]
],
'limit' => 123,
'orderBy' => [
[
'attribute' => '<string>'
]
],
'source' => '<string>',
'startDate' => '2023-11-07T05:31:56Z',
'daysOfWeek' => [
123
],
'nextPage' => '<string>',
'timeAttribute' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getcortexapp.com/api/v1/eng-intel/trace"
payload := strings.NewReader("{\n \"attributes\": [\n \"<string>\"\n ],\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"filters\": [\n {\n \"attribute\": \"<string>\",\n \"predicate\": {}\n }\n ],\n \"limit\": 123,\n \"orderBy\": [\n {\n \"attribute\": \"<string>\"\n }\n ],\n \"source\": \"<string>\",\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"daysOfWeek\": [\n 123\n ],\n \"nextPage\": \"<string>\",\n \"timeAttribute\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getcortexapp.com/api/v1/eng-intel/trace")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"attributes\": [\n \"<string>\"\n ],\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"filters\": [\n {\n \"attribute\": \"<string>\",\n \"predicate\": {}\n }\n ],\n \"limit\": 123,\n \"orderBy\": [\n {\n \"attribute\": \"<string>\"\n }\n ],\n \"source\": \"<string>\",\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"daysOfWeek\": [\n 123\n ],\n \"nextPage\": \"<string>\",\n \"timeAttribute\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getcortexapp.com/api/v1/eng-intel/trace")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"attributes\": [\n \"<string>\"\n ],\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"filters\": [\n {\n \"attribute\": \"<string>\",\n \"predicate\": {}\n }\n ],\n \"limit\": 123,\n \"orderBy\": [\n {\n \"attribute\": \"<string>\"\n }\n ],\n \"source\": \"<string>\",\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"daysOfWeek\": [\n 123\n ],\n \"nextPage\": \"<string>\",\n \"timeAttribute\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"columns": [
{
"alias": "<string>",
"name": "<string>",
"ordinal": 123,
"type": "<string>",
"aggregationFunction": "SUM",
"attributeName": "<string>",
"resultType": "STRING",
"category": "<string>",
"description": "<string>"
}
],
"nextPage": "<string>"
},
"rows": [
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
[
"cortexapps/brain-app",
7,
null
]
]
}{
"metadata": {
"columns": [
{
"alias": "<string>",
"name": "<string>",
"ordinal": 123,
"type": "<string>",
"aggregationFunction": "SUM",
"attributeName": "<string>",
"resultType": "STRING",
"category": "<string>",
"description": "<string>"
}
],
"nextPage": "<string>"
},
"rows": [
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
[
"cortexapps/brain-app",
7,
null
]
]
}{
"metadata": {
"columns": [
{
"alias": "<string>",
"name": "<string>",
"ordinal": 123,
"type": "<string>",
"aggregationFunction": "SUM",
"attributeName": "<string>",
"resultType": "STRING",
"category": "<string>",
"description": "<string>"
}
],
"nextPage": "<string>"
},
"rows": [
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
[
"cortexapps/brain-app",
7,
null
]
]
}{
"status": 429,
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"instance": "<string>",
"retryAfter": 1
}Query raw trace events from engineering data sources
Retrieve individual event records with flexible filtering, ordering, and pagination. Supports any engineering data source registered in the registry.
POST
/
api
/
v1
/
eng-intel
/
trace
Query raw trace events from engineering data sources
curl --request POST \
--url https://api.getcortexapp.com/api/v1/eng-intel/trace \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"attributes": [
"<string>"
],
"endDate": "2023-11-07T05:31:56Z",
"filters": [
{
"attribute": "<string>",
"predicate": {}
}
],
"limit": 123,
"orderBy": [
{
"attribute": "<string>"
}
],
"source": "<string>",
"startDate": "2023-11-07T05:31:56Z",
"daysOfWeek": [
123
],
"nextPage": "<string>",
"timeAttribute": "<string>"
}
'import requests
url = "https://api.getcortexapp.com/api/v1/eng-intel/trace"
payload = {
"attributes": ["<string>"],
"endDate": "2023-11-07T05:31:56Z",
"filters": [
{
"attribute": "<string>",
"predicate": {}
}
],
"limit": 123,
"orderBy": [{ "attribute": "<string>" }],
"source": "<string>",
"startDate": "2023-11-07T05:31:56Z",
"daysOfWeek": [123],
"nextPage": "<string>",
"timeAttribute": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
attributes: ['<string>'],
endDate: '2023-11-07T05:31:56Z',
filters: [{attribute: '<string>', predicate: {}}],
limit: 123,
orderBy: [{attribute: '<string>'}],
source: '<string>',
startDate: '2023-11-07T05:31:56Z',
daysOfWeek: [123],
nextPage: '<string>',
timeAttribute: '<string>'
})
};
fetch('https://api.getcortexapp.com/api/v1/eng-intel/trace', 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.getcortexapp.com/api/v1/eng-intel/trace",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'attributes' => [
'<string>'
],
'endDate' => '2023-11-07T05:31:56Z',
'filters' => [
[
'attribute' => '<string>',
'predicate' => [
]
]
],
'limit' => 123,
'orderBy' => [
[
'attribute' => '<string>'
]
],
'source' => '<string>',
'startDate' => '2023-11-07T05:31:56Z',
'daysOfWeek' => [
123
],
'nextPage' => '<string>',
'timeAttribute' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.getcortexapp.com/api/v1/eng-intel/trace"
payload := strings.NewReader("{\n \"attributes\": [\n \"<string>\"\n ],\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"filters\": [\n {\n \"attribute\": \"<string>\",\n \"predicate\": {}\n }\n ],\n \"limit\": 123,\n \"orderBy\": [\n {\n \"attribute\": \"<string>\"\n }\n ],\n \"source\": \"<string>\",\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"daysOfWeek\": [\n 123\n ],\n \"nextPage\": \"<string>\",\n \"timeAttribute\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.getcortexapp.com/api/v1/eng-intel/trace")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"attributes\": [\n \"<string>\"\n ],\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"filters\": [\n {\n \"attribute\": \"<string>\",\n \"predicate\": {}\n }\n ],\n \"limit\": 123,\n \"orderBy\": [\n {\n \"attribute\": \"<string>\"\n }\n ],\n \"source\": \"<string>\",\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"daysOfWeek\": [\n 123\n ],\n \"nextPage\": \"<string>\",\n \"timeAttribute\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getcortexapp.com/api/v1/eng-intel/trace")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"attributes\": [\n \"<string>\"\n ],\n \"endDate\": \"2023-11-07T05:31:56Z\",\n \"filters\": [\n {\n \"attribute\": \"<string>\",\n \"predicate\": {}\n }\n ],\n \"limit\": 123,\n \"orderBy\": [\n {\n \"attribute\": \"<string>\"\n }\n ],\n \"source\": \"<string>\",\n \"startDate\": \"2023-11-07T05:31:56Z\",\n \"daysOfWeek\": [\n 123\n ],\n \"nextPage\": \"<string>\",\n \"timeAttribute\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"columns": [
{
"alias": "<string>",
"name": "<string>",
"ordinal": 123,
"type": "<string>",
"aggregationFunction": "SUM",
"attributeName": "<string>",
"resultType": "STRING",
"category": "<string>",
"description": "<string>"
}
],
"nextPage": "<string>"
},
"rows": [
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
[
"cortexapps/brain-app",
7,
null
]
]
}{
"metadata": {
"columns": [
{
"alias": "<string>",
"name": "<string>",
"ordinal": 123,
"type": "<string>",
"aggregationFunction": "SUM",
"attributeName": "<string>",
"resultType": "STRING",
"category": "<string>",
"description": "<string>"
}
],
"nextPage": "<string>"
},
"rows": [
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
[
"cortexapps/brain-app",
7,
null
]
]
}{
"metadata": {
"columns": [
{
"alias": "<string>",
"name": "<string>",
"ordinal": 123,
"type": "<string>",
"aggregationFunction": "SUM",
"attributeName": "<string>",
"resultType": "STRING",
"category": "<string>",
"description": "<string>"
}
],
"nextPage": "<string>"
},
"rows": [
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
[
"cortexapps/brain-app",
7,
null
]
]
}{
"status": 429,
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"instance": "<string>",
"retryAfter": 1
}Authorizations
All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.
Body
application/json
List of attribute names to include in results. Empty returns all attributes.
List of attribute names to include in results. Empty returns all attributes.
End of the time range to query
Filters to apply to the query
Show child attributes
Show child attributes
Maximum number of results to return (max 500)
Ordering specification for results
Show child attributes
Show child attributes
Data source to query (e.g., 'pull_requests', 'deployments')
Start of the time range to query
Optional day-of-week restriction (ISO: Monday=1..Sunday=7). When set, only events whose time attribute falls on one of these days are returned (e.g. [1,2,3,4,5] excludes weekends).
Optional day-of-week restriction (ISO: Monday=1..Sunday=7). When set, only events whose time attribute falls on one of these days are returned (e.g. [1,2,3,4,5] excludes weekends).
Pagination cursor from a previous response
Override the default time attribute for time-based filtering
Response
Successfully executed trace query
Query metadata describing the structure of returned columns
Show child attributes
Show child attributes
Result rows, one array per event. Cells are positional: the value at index i corresponds to metadata.columns[i], and its JSON type follows that column's type (string, number, boolean, or null). Rows are not keyed by column name.
Result rows, one array per event. Cells are positional: the value at index i corresponds to metadata.columns[i], and its JSON type follows that column's type (string, number, boolean, or null). Rows are not keyed by column name.
Example:
[
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
["cortexapps/brain-app", 7, null]
]
Example:
[
[
"cortexapps/brain-backend",
42,
"2026-01-15T09:30:00"
],
["cortexapps/brain-app", 7, null]
]
Last modified on September 29, 2026