Get Span

GET

projects

{project_id}

spans

{span_id}

curl --request GET \
  --url https://api.acme.rungalileo.io/v2/projects/{project_id}/spans/{span_id} \
  --header 'Galileo-API-Key: <api-key>'

{
  "spans": [
    {}
  ],
  "type": "workflow",
  "input": "<string>",
  "output": "<string>",
  "name": "",
  "created_at": "2023-11-07T05:31:56Z",
  "user_metadata": {},
  "tags": [
    "<string>"
  ],
  "status_code": 123,
  "metrics": {
    "duration_ns": 123
  },
  "id": "<string>",
  "trace_id": "<string>",
  "project_id": "<string>",
  "run_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "has_children": true,
  "metrics_batch_id": "<string>",
  "metric_info": {},
  "parent_id": "<string>"
}

Authorizations

Galileo-API-Key

string

header

required

Path Parameters

span_id

string

required

project_id

string

required

Response

200

application/json

Successful Response

input

required

Input to the trace or span.

string

required

Galileo ID of the trace or span

trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

project_id

string

required

Galileo ID of the project associated with this trace or span

run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

parent_id

string

required

Galileo ID of the parent of this span

spans

object[]

spans.input

required

Input to the trace or span.

spans.id

string

required

Galileo ID of the trace or span

spans.trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

spans.project_id

string

required

Galileo ID of the project associated with this trace or span

spans.run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

spans.parent_id

string

required

Galileo ID of the parent of this span

spans.spans

object[]

spans.spans.input

required

Input to the trace or span.

spans.spans.id

string

required

Galileo ID of the trace or span

spans.spans.trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

spans.spans.project_id

string

required

Galileo ID of the project associated with this trace or span

spans.spans.run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

spans.spans.parent_id

string

required

Galileo ID of the parent of this span

spans.spans.spans

object[]

spans.spans.spans.input

required

Input to the trace or span.

spans.spans.spans.id

string

required

Galileo ID of the trace or span

spans.spans.spans.trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

spans.spans.spans.project_id

string

required

Galileo ID of the project associated with this trace or span

spans.spans.spans.run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

spans.spans.spans.parent_id

string

required

Galileo ID of the parent of this span

spans.spans.spans.spans

object[]

spans.spans.spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

spans.spans.spans.output

Output of the trace or span.

spans.spans.spans.name

string

default:

Name of the trace or span.

spans.spans.spans.created_at

string

Timestamp of the trace or span's creation.

spans.spans.spans.user_metadata

object

Metadata associated with this trace or span.

spans.spans.spans.tags

string[]

Tags associated with this trace or span.

spans.spans.spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

spans.spans.spans.metrics

object

Metrics associated with this trace or span.

spans.spans.spans.updated_at

string | null

Timestamp of the trace or span's last update

spans.spans.spans.has_children

boolean | null

Whether or not this trace or span has child spans

spans.spans.spans.metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

spans.spans.spans.metric_info

object | null

Detailed information about the metrics associated with this trace or span

spans.spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

spans.spans.output

Output of the trace or span.

spans.spans.name

string

default:

Name of the trace or span.

spans.spans.created_at

string

Timestamp of the trace or span's creation.

spans.spans.user_metadata

object

Metadata associated with this trace or span.

spans.spans.tags

string[]

Tags associated with this trace or span.

spans.spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

spans.spans.metrics

object

Metrics associated with this trace or span.

spans.spans.updated_at

string | null

Timestamp of the trace or span's last update

spans.spans.has_children

boolean | null

Whether or not this trace or span has child spans

spans.spans.metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

spans.spans.metric_info

object | null

Detailed information about the metrics associated with this trace or span

spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

spans.output

Output of the trace or span.

spans.name

string

default:

Name of the trace or span.

spans.created_at

string

Timestamp of the trace or span's creation.

spans.user_metadata

object

Metadata associated with this trace or span.

spans.tags

string[]

Tags associated with this trace or span.

spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

spans.metrics

object

Metrics associated with this trace or span.

spans.updated_at

string | null

Timestamp of the trace or span's last update

spans.has_children

boolean | null

Whether or not this trace or span has child spans

spans.metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

spans.metric_info

object | null

Detailed information about the metrics associated with this trace or span

type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

output

Output of the trace or span.

name

string

default:

Name of the trace or span.

created_at

string

Timestamp of the trace or span's creation.

user_metadata

object

Metadata associated with this trace or span.

tags

string[]

Tags associated with this trace or span.

status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

metrics

object

Metrics associated with this trace or span.

updated_at

string | null

Timestamp of the trace or span's last update

has_children

boolean | null

Whether or not this trace or span has child spans

metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

metric_info

object | null

Detailed information about the metrics associated with this trace or span

input

required

Input to the trace or span.

string

required

Galileo ID of the trace or span

trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

project_id

string

required

Galileo ID of the project associated with this trace or span

run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

parent_id

string

required

Galileo ID of the parent of this span

spans

object[]

spans.input

required

Input to the trace or span.

spans.id

string

required

Galileo ID of the trace or span

spans.trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

spans.project_id

string

required

Galileo ID of the project associated with this trace or span

spans.run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

spans.parent_id

string

required

Galileo ID of the parent of this span

spans.spans

object[]

spans.spans.input

required

Input to the trace or span.

spans.spans.id

string

required

Galileo ID of the trace or span

spans.spans.trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

spans.spans.project_id

string

required

Galileo ID of the project associated with this trace or span

spans.spans.run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

spans.spans.parent_id

string

required

Galileo ID of the parent of this span

spans.spans.spans

object[]

spans.spans.spans.input

required

Input to the trace or span.

spans.spans.spans.id

string

required

Galileo ID of the trace or span

spans.spans.spans.trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

spans.spans.spans.project_id

string

required

Galileo ID of the project associated with this trace or span

spans.spans.spans.run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

spans.spans.spans.parent_id

string

required

Galileo ID of the parent of this span

spans.spans.spans.spans

object[]

spans.spans.spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

spans.spans.spans.output

Output of the trace or span.

spans.spans.spans.name

string

default:

Name of the trace or span.

spans.spans.spans.created_at

string

Timestamp of the trace or span's creation.

spans.spans.spans.user_metadata

object

Metadata associated with this trace or span.

spans.spans.spans.tags

string[]

Tags associated with this trace or span.

spans.spans.spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

spans.spans.spans.metrics

object

Metrics associated with this trace or span.

spans.spans.spans.updated_at

string | null

Timestamp of the trace or span's last update

spans.spans.spans.has_children

boolean | null

Whether or not this trace or span has child spans

spans.spans.spans.metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

spans.spans.spans.metric_info

object | null

Detailed information about the metrics associated with this trace or span

spans.spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

spans.spans.output

Output of the trace or span.

spans.spans.name

string

default:

Name of the trace or span.

spans.spans.created_at

string

Timestamp of the trace or span's creation.

spans.spans.user_metadata

object

Metadata associated with this trace or span.

spans.spans.tags

string[]

Tags associated with this trace or span.

spans.spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

spans.spans.metrics

object

Metrics associated with this trace or span.

spans.spans.updated_at

string | null

Timestamp of the trace or span's last update

spans.spans.has_children

boolean | null

Whether or not this trace or span has child spans

spans.spans.metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

spans.spans.metric_info

object | null

Detailed information about the metrics associated with this trace or span

spans.type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

spans.output

Output of the trace or span.

spans.name

string

default:

Name of the trace or span.

spans.created_at

string

Timestamp of the trace or span's creation.

spans.user_metadata

object

Metadata associated with this trace or span.

spans.tags

string[]

Tags associated with this trace or span.

spans.status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

spans.metrics

object

Metrics associated with this trace or span.

spans.updated_at

string | null

Timestamp of the trace or span's last update

spans.has_children

boolean | null

Whether or not this trace or span has child spans

spans.metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

spans.metric_info

object | null

Detailed information about the metrics associated with this trace or span

type

string

default:workflow

Type of the trace or span.

Allowed value: "workflow"

output

Output of the trace or span.

name

string

default:

Name of the trace or span.

created_at

string

Timestamp of the trace or span's creation.

user_metadata

object

Metadata associated with this trace or span.

tags

string[]

Tags associated with this trace or span.

status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

metrics

object

Metrics associated with this trace or span.

updated_at

string | null

Timestamp of the trace or span's last update

has_children

boolean | null

Whether or not this trace or span has child spans

metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

metric_info

object | null

Detailed information about the metrics associated with this trace or span

input

object[]

required

Input to the trace or span.

output

object

required

Output of the trace or span.

string

required

Galileo ID of the trace or span

trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

project_id

string

required

Galileo ID of the project associated with this trace or span

run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

parent_id

string

required

Galileo ID of the parent of this span

type

string

default:llm

Type of the trace or span.

Allowed value: "llm"

name

string

default:

Name of the trace or span.

created_at

string

Timestamp of the trace or span's creation.

user_metadata

object

Metadata associated with this trace or span.

tags

string[]

Tags associated with this trace or span.

status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

metrics

object

Metrics associated with this trace or span.

updated_at

string | null

Timestamp of the trace or span's last update

has_children

boolean | null

Whether or not this trace or span has child spans

metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

metric_info

object | null

Detailed information about the metrics associated with this trace or span

tools

object[] | null

List of available tools passed to the LLM on invocation.

model

string | null

Model used for this span.

temperature

number | null

Temperature used for generation.

finish_reason

string | null

Reason for finishing.

input

string

required

Input to the trace or span.

string

required

Galileo ID of the trace or span

trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

project_id

string

required

Galileo ID of the project associated with this trace or span

run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

parent_id

string

required

Galileo ID of the parent of this span

type

string

default:tool

Type of the trace or span.

Allowed value: "tool"

output

string | null

Output of the trace or span.

name

string

default:

Name of the trace or span.

created_at

string

Timestamp of the trace or span's creation.

user_metadata

object

Metadata associated with this trace or span.

tags

string[]

Tags associated with this trace or span.

status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

metrics

object

Metrics associated with this trace or span.

updated_at

string | null

Timestamp of the trace or span's last update

has_children

boolean | null

Whether or not this trace or span has child spans

metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

metric_info

object | null

Detailed information about the metrics associated with this trace or span

tool_call_id

string | null

ID of the tool call.

input

string

required

Input to the trace or span.

output

object[]

required

Output of the trace or span.

string

required

Galileo ID of the trace or span

trace_id

string

required

Galileo ID of the trace containing the span (or the same value as id for a trace)

project_id

string

required

Galileo ID of the project associated with this trace or span

run_id

string

required

Galileo ID of the run (log stream or experiment) associated with this trace or span

parent_id

string

required

Galileo ID of the parent of this span

type

string

default:retriever

Type of the trace or span.

Allowed value: "retriever"

name

string

default:

Name of the trace or span.

created_at

string

Timestamp of the trace or span's creation.

user_metadata

object

Metadata associated with this trace or span.

tags

string[]

Tags associated with this trace or span.

status_code

integer | null

Status code of the trace or span. Used for logging failure or error states.

metrics

object

Metrics associated with this trace or span.

updated_at

string | null

Timestamp of the trace or span's last update

has_children

boolean | null

Whether or not this trace or span has child spans

metrics_batch_id

string | null

Galileo ID of the metrics batch associated with this trace or span

metric_info

object | null

Detailed information about the metrics associated with this trace or span

Was this page helpful?

Suggest edits Raise issue

Get Trace List Log Streams

curl --request GET \
  --url https://api.acme.rungalileo.io/v2/projects/{project_id}/spans/{span_id} \
  --header 'Galileo-API-Key: <api-key>'

{
  "spans": [
    {}
  ],
  "type": "workflow",
  "input": "<string>",
  "output": "<string>",
  "name": "",
  "created_at": "2023-11-07T05:31:56Z",
  "user_metadata": {},
  "tags": [
    "<string>"
  ],
  "status_code": 123,
  "metrics": {
    "duration_ns": 123
  },
  "id": "<string>",
  "trace_id": "<string>",
  "project_id": "<string>",
  "run_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "has_children": true,
  "metrics_batch_id": "<string>",
  "metric_info": {},
  "parent_id": "<string>"
}

API Reference

health

auth

evaluate

observe

protect

trace

log_stream

experiment

Webhooks

Authorizations

Path Parameters

Response