Skip to main content
GET
/
v0
/
traces
/
by-test
/
{id}
JavaScript
import Avido from 'avido';

const client = new Avido({
  apiKey: process.env['AVIDO_API_KEY'], // This is the default and can be omitted
});

const response = await client.traces.retrieveByTest('123e4567-e89b-12d3-a456-426614174000');

console.log(response.data);
{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "traceId": "789e4567-e89b-12d3-a456-426614174000",
    "applicationId": "app_123",
    "timestamp": "2025-01-05T12:34:56.789Z",
    "type": "llm",
    "event": "start",
    "tokens": {
      "input": 100,
      "output": 200
    },
    "metadata": {
      "custom": "metadata"
    }
  }
}

Authorizations

x-api-key
string
header
required

Your unique Avido API key

x-application-id
string
header
required

Your unique Avido Application ID

Path Parameters

id
string<uuid>
required

The unique identifier of the trace

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

Successfully retrieved trace

Successful response containing a single trace object

data
Trace · object
required

A trace grouping related steps (e.g. a user-agent interaction or conversation).