Skip to content
GET/api/v1/traces

Query traces

Queries trace summaries from DB and/or the in-memory store. projectId is REQUIRED (400 MISSING_PROJECT_ID) - it scopes tenancy on both paths. Supports cursor (preferred) or legacy offset pagination, plus service/model/status/duration/time filters.

Authentication

Send Authorization: Bearer YOUR_API_KEY on every request. Generate API keys at /dashboard/settings/api-keys.

Parameters

projectId in queryrequired
string
source in query

Defaults to both (DB preferred).

string
serviceName in query
string
model in query
string
status in query
string
minDuration in query
integer
maxDuration in query
integer
startTime in query

Epoch ms lower bound on start_time_ms.

integer
endTime in query

Epoch ms upper bound on start_time_ms.

integer
cursor in query

Opaque keyset cursor (base64url). Preferred over offset.

string
limit in query
integer
offset in query

Legacy pagination - deprecated; emits Deprecation/Sunset headers.

integer

Response

200 example

{
  "success": false,
  "data": {
    "traces": [
      {
        "traceId": "string",
        "rootSpanName": "string",
        "duration": 0,
        "spanCount": 0,
        "services": [
          "string"
        ],
        "status": "ok",
        "startTime": 0
      }
    ],
    "total": 0,
    "source": "string",
    "nextCursor": "string",
    "paginationMode": "cursor"
  }
}

All status codes

200Trace summaries.
400(no description)
401(no description)
403Forbidden — the credential is valid but lacks the API-key scope, member role, or plan entitlement this operation requires.
429(no description)
500Internal Server Error — an unhandled error was converted to the standard error envelope (INTERNAL_ERROR).

Code samples

cURL

curl -X GET \
  https://evalguard.ai/api/v1/traces \
  -H "Authorization: Bearer $EVALGUARD_API_KEY"

TypeScript

// The TypeScript SDK (@evalguard/sdk) exposes TYPED methods — runEval,
// getEval, runSecurityScan, checkFirewall, … — not a generic request().
// For an arbitrary endpoint, call it directly:

const res = await fetch("https://evalguard.ai/api/v1/traces", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.EVALGUARD_API_KEY}` },
});
console.log(res.status, await res.json());

Python

# The Python SDK (pip install evalguardai) exposes TYPED methods on
# EvalGuardClient — run_eval, get_eval, … — not a generic request().
# For an arbitrary endpoint, call it directly:

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['EVALGUARD_API_KEY']}"}

response = requests.request("GET", "https://evalguard.ai/api/v1/traces", headers=headers)
print(response.status_code, response.json())

Go

package main

import (
	"context"
	"fmt"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequestWithContext(context.Background(), "GET", "https://evalguard.ai/api/v1/traces", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("EVALGUARD_API_KEY"))
	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	fmt.Println(resp.Status)
}

Errors

400401403429500

Other Traces endpoints