Search and list spans

curl --request POST \
  --url https://api.egp.scale.com/v5/spans/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "parents_only": true,
  "span_ids": [
    "<string>"
  ],
  "trace_ids": [
    "<string>"
  ],
  "excluded_span_ids": [
    "<string>"
  ],
  "excluded_trace_ids": [
    "<string>"
  ],
  "group_id": "<string>",
  "names": [
    "<string>"
  ],
  "statuses": [],
  "types": [],
  "search_texts": [
    "<string>"
  ],
  "extra_metadata": {},
  "application_variant_ids": [
    "<string>"
  ],
  "assessment_types": [
    "<string>"
  ],
  "acp_types": [
    "<string>"
  ],
  "agentex_agent_names": [
    "<string>"
  ],
  "agentex_agent_ids": [
    "<string>"
  ],
  "min_duration_ms": 123,
  "max_duration_ms": 123
}
'

import requests

url = "https://api.egp.scale.com/v5/spans/search"

payload = {
    "parents_only": True,
    "span_ids": ["<string>"],
    "trace_ids": ["<string>"],
    "excluded_span_ids": ["<string>"],
    "excluded_trace_ids": ["<string>"],
    "group_id": "<string>",
    "names": ["<string>"],
    "statuses": [],
    "types": [],
    "search_texts": ["<string>"],
    "extra_metadata": {},
    "application_variant_ids": ["<string>"],
    "assessment_types": ["<string>"],
    "acp_types": ["<string>"],
    "agentex_agent_names": ["<string>"],
    "agentex_agent_ids": ["<string>"],
    "min_duration_ms": 123,
    "max_duration_ms": 123
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    parents_only: true,
    span_ids: ['<string>'],
    trace_ids: ['<string>'],
    excluded_span_ids: ['<string>'],
    excluded_trace_ids: ['<string>'],
    group_id: '<string>',
    names: ['<string>'],
    statuses: [],
    types: [],
    search_texts: ['<string>'],
    extra_metadata: {},
    application_variant_ids: ['<string>'],
    assessment_types: ['<string>'],
    acp_types: ['<string>'],
    agentex_agent_names: ['<string>'],
    agentex_agent_ids: ['<string>'],
    min_duration_ms: 123,
    max_duration_ms: 123
  })
};

fetch('https://api.egp.scale.com/v5/spans/search', 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.egp.scale.com/v5/spans/search",
  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([
    'parents_only' => true,
    'span_ids' => [
        '<string>'
    ],
    'trace_ids' => [
        '<string>'
    ],
    'excluded_span_ids' => [
        '<string>'
    ],
    'excluded_trace_ids' => [
        '<string>'
    ],
    'group_id' => '<string>',
    'names' => [
        '<string>'
    ],
    'statuses' => [
        
    ],
    'types' => [
        
    ],
    'search_texts' => [
        '<string>'
    ],
    'extra_metadata' => [
        
    ],
    'application_variant_ids' => [
        '<string>'
    ],
    'assessment_types' => [
        '<string>'
    ],
    'acp_types' => [
        '<string>'
    ],
    'agentex_agent_names' => [
        '<string>'
    ],
    'agentex_agent_ids' => [
        '<string>'
    ],
    'min_duration_ms' => 123,
    'max_duration_ms' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.egp.scale.com/v5/spans/search"

	payload := strings.NewReader("{\n  \"parents_only\": true,\n  \"span_ids\": [\n    \"<string>\"\n  ],\n  \"trace_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_span_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_trace_ids\": [\n    \"<string>\"\n  ],\n  \"group_id\": \"<string>\",\n  \"names\": [\n    \"<string>\"\n  ],\n  \"statuses\": [],\n  \"types\": [],\n  \"search_texts\": [\n    \"<string>\"\n  ],\n  \"extra_metadata\": {},\n  \"application_variant_ids\": [\n    \"<string>\"\n  ],\n  \"assessment_types\": [\n    \"<string>\"\n  ],\n  \"acp_types\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_names\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_ids\": [\n    \"<string>\"\n  ],\n  \"min_duration_ms\": 123,\n  \"max_duration_ms\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	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.egp.scale.com/v5/spans/search")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"parents_only\": true,\n  \"span_ids\": [\n    \"<string>\"\n  ],\n  \"trace_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_span_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_trace_ids\": [\n    \"<string>\"\n  ],\n  \"group_id\": \"<string>\",\n  \"names\": [\n    \"<string>\"\n  ],\n  \"statuses\": [],\n  \"types\": [],\n  \"search_texts\": [\n    \"<string>\"\n  ],\n  \"extra_metadata\": {},\n  \"application_variant_ids\": [\n    \"<string>\"\n  ],\n  \"assessment_types\": [\n    \"<string>\"\n  ],\n  \"acp_types\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_names\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_ids\": [\n    \"<string>\"\n  ],\n  \"min_duration_ms\": 123,\n  \"max_duration_ms\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.egp.scale.com/v5/spans/search")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"parents_only\": true,\n  \"span_ids\": [\n    \"<string>\"\n  ],\n  \"trace_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_span_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_trace_ids\": [\n    \"<string>\"\n  ],\n  \"group_id\": \"<string>\",\n  \"names\": [\n    \"<string>\"\n  ],\n  \"statuses\": [],\n  \"types\": [],\n  \"search_texts\": [\n    \"<string>\"\n  ],\n  \"extra_metadata\": {},\n  \"application_variant_ids\": [\n    \"<string>\"\n  ],\n  \"assessment_types\": [\n    \"<string>\"\n  ],\n  \"acp_types\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_names\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_ids\": [\n    \"<string>\"\n  ],\n  \"min_duration_ms\": 123,\n  \"max_duration_ms\": 123\n}"

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

{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "trace_id": "<string>",
      "start_timestamp": "2023-11-07T05:31:56Z",
      "account_id": "<string>",
      "object": "span",
      "created_by": {
        "id": "<string>",
        "object": "identity"
      },
      "parent_id": "<string>",
      "group_id": "<string>",
      "end_timestamp": "2023-11-07T05:31:56Z",
      "input": {},
      "output": {},
      "metadata": {},
      "expected": {},
      "status": "SUCCESS",
      "type": "STANDALONE",
      "application_interaction_id": "<string>",
      "application_variant_id": "<string>"
    }
  ],
  "total": 123,
  "has_more": true,
  "object": "list",
  "limit": 100
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

POST

spans

Search and list spans

curl --request POST \
  --url https://api.egp.scale.com/v5/spans/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "parents_only": true,
  "span_ids": [
    "<string>"
  ],
  "trace_ids": [
    "<string>"
  ],
  "excluded_span_ids": [
    "<string>"
  ],
  "excluded_trace_ids": [
    "<string>"
  ],
  "group_id": "<string>",
  "names": [
    "<string>"
  ],
  "statuses": [],
  "types": [],
  "search_texts": [
    "<string>"
  ],
  "extra_metadata": {},
  "application_variant_ids": [
    "<string>"
  ],
  "assessment_types": [
    "<string>"
  ],
  "acp_types": [
    "<string>"
  ],
  "agentex_agent_names": [
    "<string>"
  ],
  "agentex_agent_ids": [
    "<string>"
  ],
  "min_duration_ms": 123,
  "max_duration_ms": 123
}
'

import requests

url = "https://api.egp.scale.com/v5/spans/search"

payload = {
    "parents_only": True,
    "span_ids": ["<string>"],
    "trace_ids": ["<string>"],
    "excluded_span_ids": ["<string>"],
    "excluded_trace_ids": ["<string>"],
    "group_id": "<string>",
    "names": ["<string>"],
    "statuses": [],
    "types": [],
    "search_texts": ["<string>"],
    "extra_metadata": {},
    "application_variant_ids": ["<string>"],
    "assessment_types": ["<string>"],
    "acp_types": ["<string>"],
    "agentex_agent_names": ["<string>"],
    "agentex_agent_ids": ["<string>"],
    "min_duration_ms": 123,
    "max_duration_ms": 123
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    parents_only: true,
    span_ids: ['<string>'],
    trace_ids: ['<string>'],
    excluded_span_ids: ['<string>'],
    excluded_trace_ids: ['<string>'],
    group_id: '<string>',
    names: ['<string>'],
    statuses: [],
    types: [],
    search_texts: ['<string>'],
    extra_metadata: {},
    application_variant_ids: ['<string>'],
    assessment_types: ['<string>'],
    acp_types: ['<string>'],
    agentex_agent_names: ['<string>'],
    agentex_agent_ids: ['<string>'],
    min_duration_ms: 123,
    max_duration_ms: 123
  })
};

fetch('https://api.egp.scale.com/v5/spans/search', 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.egp.scale.com/v5/spans/search",
  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([
    'parents_only' => true,
    'span_ids' => [
        '<string>'
    ],
    'trace_ids' => [
        '<string>'
    ],
    'excluded_span_ids' => [
        '<string>'
    ],
    'excluded_trace_ids' => [
        '<string>'
    ],
    'group_id' => '<string>',
    'names' => [
        '<string>'
    ],
    'statuses' => [
        
    ],
    'types' => [
        
    ],
    'search_texts' => [
        '<string>'
    ],
    'extra_metadata' => [
        
    ],
    'application_variant_ids' => [
        '<string>'
    ],
    'assessment_types' => [
        '<string>'
    ],
    'acp_types' => [
        '<string>'
    ],
    'agentex_agent_names' => [
        '<string>'
    ],
    'agentex_agent_ids' => [
        '<string>'
    ],
    'min_duration_ms' => 123,
    'max_duration_ms' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.egp.scale.com/v5/spans/search"

	payload := strings.NewReader("{\n  \"parents_only\": true,\n  \"span_ids\": [\n    \"<string>\"\n  ],\n  \"trace_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_span_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_trace_ids\": [\n    \"<string>\"\n  ],\n  \"group_id\": \"<string>\",\n  \"names\": [\n    \"<string>\"\n  ],\n  \"statuses\": [],\n  \"types\": [],\n  \"search_texts\": [\n    \"<string>\"\n  ],\n  \"extra_metadata\": {},\n  \"application_variant_ids\": [\n    \"<string>\"\n  ],\n  \"assessment_types\": [\n    \"<string>\"\n  ],\n  \"acp_types\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_names\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_ids\": [\n    \"<string>\"\n  ],\n  \"min_duration_ms\": 123,\n  \"max_duration_ms\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	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.egp.scale.com/v5/spans/search")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"parents_only\": true,\n  \"span_ids\": [\n    \"<string>\"\n  ],\n  \"trace_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_span_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_trace_ids\": [\n    \"<string>\"\n  ],\n  \"group_id\": \"<string>\",\n  \"names\": [\n    \"<string>\"\n  ],\n  \"statuses\": [],\n  \"types\": [],\n  \"search_texts\": [\n    \"<string>\"\n  ],\n  \"extra_metadata\": {},\n  \"application_variant_ids\": [\n    \"<string>\"\n  ],\n  \"assessment_types\": [\n    \"<string>\"\n  ],\n  \"acp_types\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_names\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_ids\": [\n    \"<string>\"\n  ],\n  \"min_duration_ms\": 123,\n  \"max_duration_ms\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.egp.scale.com/v5/spans/search")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"parents_only\": true,\n  \"span_ids\": [\n    \"<string>\"\n  ],\n  \"trace_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_span_ids\": [\n    \"<string>\"\n  ],\n  \"excluded_trace_ids\": [\n    \"<string>\"\n  ],\n  \"group_id\": \"<string>\",\n  \"names\": [\n    \"<string>\"\n  ],\n  \"statuses\": [],\n  \"types\": [],\n  \"search_texts\": [\n    \"<string>\"\n  ],\n  \"extra_metadata\": {},\n  \"application_variant_ids\": [\n    \"<string>\"\n  ],\n  \"assessment_types\": [\n    \"<string>\"\n  ],\n  \"acp_types\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_names\": [\n    \"<string>\"\n  ],\n  \"agentex_agent_ids\": [\n    \"<string>\"\n  ],\n  \"min_duration_ms\": 123,\n  \"max_duration_ms\": 123\n}"

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

{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "trace_id": "<string>",
      "start_timestamp": "2023-11-07T05:31:56Z",
      "account_id": "<string>",
      "object": "span",
      "created_by": {
        "id": "<string>",
        "object": "identity"
      },
      "parent_id": "<string>",
      "group_id": "<string>",
      "end_timestamp": "2023-11-07T05:31:56Z",
      "input": {},
      "output": {},
      "metadata": {},
      "expected": {},
      "status": "SUCCESS",
      "type": "STANDALONE",
      "application_interaction_id": "<string>",
      "application_variant_id": "<string>"
    }
  ],
  "total": 123,
  "has_more": true,
  "object": "list",
  "limit": 100
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

x-api-key

string

header

required

Headers

x-selected-account-id

string | null

Query Parameters

starting_after

string | null

ending_before

string | null

limit

integer

default:100

Required range: 1 <= x <= 10000

sort_by

string | null

sort_order

enum<string> | null

default:asc

Available options:

asc,

desc

from_ts

string<date-time> | null

The starting (oldest) timestamp in ISO format.

to_ts

string<date-time> | null

The ending (most recent) timestamp in ISO format.

Body

application/json

parents_only

boolean

Only fetch spans that are the top-level (ie. have no parent_id)

span_ids

string[]

Filter by span IDs

trace_ids

string[]

Filter by trace IDs

excluded_span_ids

string[]

List of span IDs to exclude from results

excluded_trace_ids

string[]

List of trace IDs to exclude from results

group_id

string

Filter by group ID

names

string[]

Filter by trace/span name

statuses

enum<string>[]

Filter on span status

Available options:

SUCCESS,

ERROR,

CANCELED

types

enum<string>[]

Available options:

TEXT_INPUT,

TEXT_OUTPUT,

COMPLETION_INPUT,

COMPLETION,

KB_RETRIEVAL,

KB_INPUT,

RERANKING,

EXTERNAL_ENDPOINT,

PROMPT_ENGINEERING,

DOCUMENT_INPUT,

MAP_REDUCE,

DOCUMENT_SEARCH,

DOCUMENT_PROMPT,

CUSTOM,

CODE_EXECUTION,

DATA_MANIPULATION,

EVALUATION,

FILE_RETRIEVAL,

KB_ADD_CHUNK,

KB_MANAGEMENT,

GUARDRAIL,

OUTPUT_GUARDRAIL,

TRACER,

AGENT_TRACER,

AGENT_WORKFLOW,

STANDALONE

search_texts

string[]

Free text search across span input and output fields. For exact trace ID lookup, use the trace_ids filter.

extra_metadata

Extra Metadata · object

Filter on custom metadata key-value pairs

application_variant_ids

string[]

Filter by application variant IDs

assessment_types

string[]

Filter spans by traces that have assessments of these types

acp_types

string[]

Filter by ACP types

agentex_agent_names

string[]

Filter by Agentex agent names

agentex_agent_ids

string[]

Filter by Agentex agent IDs

min_duration_ms

integer

Minimum span duration in milliseconds (inclusive)

max_duration_ms

integer

Maximum span duration in milliseconds (inclusive)

Response

Successful Response

items

Items · object[]

required

Show child attributes

total

integer

required

The total of items that match the query. This is greater than or equal to the number of items returned.

has_more

boolean

required

Whether there are more items left to be fetched.

object

string

default:list

Allowed value: "list"

limit

integer

default:100

The maximum number of items to return.

Update Span Export spans

⌘I

Inference

Questions

Rubrics

Vector Stores

Files

Models

Agent Configs

Datasets

Dataset Items

Agent Evaluations

Evaluations

Evaluation Groups

Evaluation Charts

Evaluation Dashboards

Evaluation Items

Spans

Span Assessment

Credentials

Agentex Cloud Build

Agentex Cloud Deploy

SGP Cloud Secrets

Search and list spans

Authorizations

Headers

Query Parameters

Body

Response