GET /api/v1/guard/results
Use this to build dashboards and analytics. Results can be filtered by project_id or by a specific scan_id if your integration stores the ID returned by /guard (when enabled).
Query parameters
project_id(optional) — return scans for this project.scan_id(optional) — return details for a specific scan (if available).- Pagination parameters (optional) —
page,per_page.
Example response (shape)
{
"data": [
{
"id": "scan_01HXXX...",
"created_at": "2025-09-20T16:10:00Z",
"flagged": true,
"summary": { "matches": 1, "detectors": ["LLM03"] }
}
],
"meta": { "page": 1, "per_page": 25, "total": 1 }
}
Examples
Python
import requests
BASE = "https://sagexai.com"
TOKEN = "<YOUR_TOKEN>"
params = {"project_id": "demo", "per_page": 25}
r = requests.get(f"{BASE}/api/v1/guard/results", headers={
"Authorization": f"Bearer {TOKEN}"
}, params=params, timeout=30)
print(r.status_code, r.json())
JavaScript
const BASE = "https://sagexai.com";
const TOKEN = "<YOUR_TOKEN>";
const url = new URL(`${BASE}/api/v1/guard/results`);
url.searchParams.set("project_id", "demo");
url.searchParams.set("per_page", "25");
const res = await fetch(url, { headers: { "Authorization": `Bearer ${TOKEN}` } });
console.log(res.status, await res.json());
TypeScript
const BASE = "https://sagexai.com";
const TOKEN = "<YOUR_TOKEN>";
const url = new URL(`${BASE}/api/v1/guard/results`);
url.searchParams.set("project_id", "demo");
url.searchParams.set("per_page", "25");
const res = await fetch(url, { headers: { "Authorization": `Bearer ${TOKEN}` } });
console.log(res.status, await res.json());
Java
import java.net.http.*;
import java.net.URI;
public class ResultsExample {
public static void main(String[] args) throws Exception {
String BASE = "https://sagexai.com";
String TOKEN = "<YOUR_TOKEN>";
String url = BASE + "/api/v1/guard/results";
HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder(URI.create(url))
.header("Authorization", "Bearer " + TOKEN)
.GET().build();
HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.statusCode());
System.out.println(res.body());
}
}
C#
using System;
using System.Net.Http;
using System.Net.Http.Headers;
var BASE = "https://sagexai.com";
var TOKEN = "<YOUR_TOKEN>";
var url = $"{BASE}/api/v1/guard/results";
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", TOKEN);
var resp = await client.GetAsync(url);
Console.WriteLine((int)resp.StatusCode);
Console.WriteLine(await resp.Content.ReadAsStringAsync());
C++
#include <curl/curl.h>
#include <iostream>
int main() {
CURL* curl = curl_easy_init();
if(!curl) return 1;
const char* BASE = "https://sagexai.com";
const char* TOKEN = "<YOUR_TOKEN>";
std::string url = std::string(BASE) + "/api/v1/guard/results";
struct curl_slist* headers = NULL;
headers = curl_slist_append(headers, ("Authorization: Bearer " + std::string(TOKEN)).c_str());
curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
CURLcode res = curl_easy_perform(curl);
if (res != CURLE_OK) std::cerr << "curl error: " << curl_easy_strerror(res) << "\n";
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return 0;
}
PHP
<?php
$BASE = "https://sagexai.com";
$TOKEN = "<YOUR_TOKEN>";
$url = "$BASE/api/v1/guard/results";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $TOKEN"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $code . PHP_EOL . $response;
Go
package main
import (
"fmt"
"net/http"
"time"
)
func main() {
base := "https://sagexai.com";
token := "<YOUR_TOKEN>";
url := base + "/api/v1/guard/results";
req, _ := http.NewRequest("GET", url, nil);
req.Header.Set("Authorization", "Bearer "+token);
client := &http.Client{ Timeout: 15 * time.Second };
resp, err := client.Do(req);
if (err != nil) { panic(err) }
defer resp.Body.Close();
fmt.Println("Status:", resp.Status);
}
Rust
use reqwest::blocking::Client;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let base = "https://sagexai.com";
let token = "<YOUR_TOKEN>";
let url = format!("{}/api/v1/guard/results", base);
let res = Client::new()
.get(url)
.bearer_auth(token)
.send()?;
println!("Status: {}", res.status());
println!("{}", res.text()?);
Ok(())
}