Dashboard Gate Traces

GET/api/v1/brands/{brand_id}/gate/traces

List Traces

List traces for a brand. Proxies LangFuse with DB fallback.

Parameters

Name	In	Type	Required
`brand_id`	path	integer	true
`page`	query	integer	false
`limit`	query	integer	false
`agent_id`	query	any	false
`model`	query	any	false
`status`	query	any	false
`from_date`	query	any	false
`to_date`	query	any	false
`min_latency_ms`	query	any	false
`min_cost_usd`	query	any	false

Try it

Examples

cURL

curl -X GET 'https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces' \
  -H 'Authorization: Bearer <token>'

Python

import httpx

resp = httpx.get(
    "https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);

Go

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error

GET/api/v1/brands/{brand_id}/gate/traces/{trace_id}

Get Trace Detail

Get full trace detail with spans and content.

Parameters

Name	In	Type	Required	Description
`brand_id`	path	integer	true
`trace_id`	path	string	true

Try it

Examples

cURL

curl -X GET 'https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/{trace_id}' \
  -H 'Authorization: Bearer <token>'

Python

import httpx

resp = httpx.get(
    "https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/{trace_id}",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/{trace_id}", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);

Go

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/{trace_id}", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error

GET/api/v1/brands/{brand_id}/gate/traces/stats/summary

Get Trace Stats

Aggregated trace statistics from gate_request_logs.

Parameters

Name	In	Type	Required
`brand_id`	path	integer	true
`days`	query	integer	false
`agent_id`	query	any	false
`model`	query	any	false

Try it

Examples

cURL

curl -X GET 'https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/stats/summary' \
  -H 'Authorization: Bearer <token>'

Python

import httpx

resp = httpx.get(
    "https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/stats/summary",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/stats/summary", {
  method: "GET",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);

Go

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://spideriq.ai/api/v1/brands/{brand_id}/gate/traces/stats/summary", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error