List traces with optional evaluation summary

curl --request GET \
  --url https://backend.trusys.ai/api/external/applications/{applicationId}/traces \
  --header 'x-api-key: <api-key>'

import requests

url = "https://backend.trusys.ai/api/external/applications/{applicationId}/traces"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://backend.trusys.ai/api/external/applications/{applicationId}/traces', 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://backend.trusys.ai/api/external/applications/{applicationId}/traces",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://backend.trusys.ai/api/external/applications/{applicationId}/traces"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://backend.trusys.ai/api/external/applications/{applicationId}/traces")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "results": [
      {
        "traceId": "<string>",
        "applicationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "startTime": "2023-11-07T05:31:56Z",
        "endTime": "2023-11-07T05:31:56Z",
        "spanCount": 123,
        "evaluation": {
          "evaluated": true,
          "evalId": "<string>",
          "success": true,
          "score": 123,
          "failureReason": 123,
          "hasError": true,
          "metricNames": [
            "<string>"
          ],
          "evaluatedAt": "2023-11-07T05:31:56Z"
        }
      }
    ],
    "count": 123,
    "page": 123,
    "limit": 123
  }
}

{
  "success": false,
  "message": "Invalid request body",
  "errors": [
    {
      "path": "name",
      "message": "name is required"
    }
  ]
}

{
  "message": "Error while verifying api key"
}

{
  "success": false,
  "message": "Application not found"
}

List traces with optional evaluation summary

Returns a paginated list of traces for an application in the requested time range. Includes traces with or without evaluation results.

Each row includes trace metadata (timing, span count, status). Evaluated traces include a compact evaluation summary — not full span or detailed evaluation payloads.

Source (source): monitoring, security, or all (default).

Outcome (outcome): all (default) returns every trace in range. Use pass, fail, or error to filter traces by overall evaluation result.

Metric filter (metricName): optional metric or security plugin name. Combine with outcome pass, fail, or error to return only traces where that specific metric passed, failed, or errored.

GET

applications

{applicationId}

traces

List traces with optional evaluation summary

curl --request GET \
  --url https://backend.trusys.ai/api/external/applications/{applicationId}/traces \
  --header 'x-api-key: <api-key>'

import requests

url = "https://backend.trusys.ai/api/external/applications/{applicationId}/traces"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://backend.trusys.ai/api/external/applications/{applicationId}/traces', 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://backend.trusys.ai/api/external/applications/{applicationId}/traces",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://backend.trusys.ai/api/external/applications/{applicationId}/traces"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://backend.trusys.ai/api/external/applications/{applicationId}/traces")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "results": [
      {
        "traceId": "<string>",
        "applicationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "startTime": "2023-11-07T05:31:56Z",
        "endTime": "2023-11-07T05:31:56Z",
        "spanCount": 123,
        "evaluation": {
          "evaluated": true,
          "evalId": "<string>",
          "success": true,
          "score": 123,
          "failureReason": 123,
          "hasError": true,
          "metricNames": [
            "<string>"
          ],
          "evaluatedAt": "2023-11-07T05:31:56Z"
        }
      }
    ],
    "count": 123,
    "page": 123,
    "limit": 123
  }
}

{
  "success": false,
  "message": "Invalid request body",
  "errors": [
    {
      "path": "name",
      "message": "name is required"
    }
  ]
}

{
  "message": "Error while verifying api key"
}

{
  "success": false,
  "message": "Application not found"
}

Authorizations

x-api-key

string

header

required

Your Trusys API key. Create and manage keys in the Trusys UI under Settings → API Keys.

Include the key on every request:

x-api-key: <your-api-key>

Path Parameters

applicationId

string<uuid>

required

Unique identifier (UUID) of the application. Returned by POST /applications.

Query Parameters

start

string<date-time>

required

Start of the time range, inclusive. ISO 8601 datetime in UTC (for example 2026-07-01T00:00:00.000Z).

end

string<date-time>

required

End of the time range, inclusive. Must be the same as or after start. ISO 8601 datetime in UTC.

source

enum<string>

default:all

Available options:

monitoring,

security,

all

outcome

enum<string>

default:all

Available options:

all,

pass,

fail,

error

metricName

string

Optional metric or security plugin name. With outcome set to pass, fail, or error, filters to traces where that metric scored accordingly.

page

integer

default:1

Page number for paginated results (1-based).

Required range: x >= 1

limit

integer

default:20

Maximum number of applications per page (max 100).

Required range: 1 <= x <= 100

Response

Paginated trace list with optional evaluation summary.

success

boolean

Example:

true

data

object

Show child attributes