You can query data via: SDKs and API. For export functionality, see Export Data.
Common use cases:
- Train or fine-tune models on the production traces in ABV. E.g. to create a small model after having used a large model in production for a specific use case.
- Collect few-shot examples to improve quality of output.
- Programmatically create datasets.
New data is typically available for querying within 15-30 seconds of ingestion, though processing times may vary at times. Please visit status page if you encounter any issues. SDKs
Via the SDKs for Python and JS/TS you can easily query the API without having to write the HTTP requests yourself.
Python SDK
from abvdev import ABV
abv = ABV(
api_key="sk-abv-...", # your api key here
host="https://app.abv.dev", # host="https://eu.app.abv.dev", for EU region
)
api namespace is auto-generated from the Public API (OpenAPI). Method names mirror REST resources and support filters and pagination.
Traces
traces = abv.api.trace.list(limit=100, user_id="user_123", tags=["production"]) # pagination via cursor
trace = abv.api.trace.get("traceId")
Observations
observations = abv.api.observations.get_many(trace_id="abcdef1234", type="GENERATION", limit=100)
observation = abv.api.observations.get("observationId")
Sessions
sessions = abv.api.sessions.list(limit=50)
Scores
abv.api.score_v_2.get(score_ids = "ScoreId")
Prompts
Please refer to the prompt management documentation on fetching prompts.
Datasets
# Namespaces:
# - abv.api.datasets.*
# - abv.api.dataset_items.*
# - abv.api.dataset_run_items.*
Metrics
query = """
{
"view": "traces",
"metrics": [{"measure": "count", "aggregation": "count"}],
"dimensions": [{"field": "name"}],
"filters": [],
"fromTimestamp": "2025-05-01T00:00:00Z",
"toTimestamp": "2025-05-13T00:00:00Z"
}
"""
abv.api.metrics.metrics(query = query)
Async equivalents
# All endpoints are also available as async under `async_api`:
trace = await abv.async_api.trace.get("traceId")
traces = await abv.async_api.trace.list(limit=100)
- limit, cursor (pagination)
- time range filters (e.g., start_time, end_time)
- entity filters: user_id, session_id, trace_id, type, name, tags, level, etc.
See the Public API for the exact parameters per resource.
JS/TS SDK
The dedicated fetch* methods for core entities are covered by tests and semantic versioning. The methods on the abv.api are auto-generated from the API reference and cover all entities.
npm install @abvdev/client
ABV_API_KEY="sk-abv-..."
ABV_BASEURL="https://app.abv.dev" # US region
# ABV_BASEURL="https://eu.app.abv.dev" # EU region
import { ABVClient } from "@abvdev/client";
const abv = new ABVClient();
import { ABVClient } from "@abvdev/client";
const abv = new ABVClient({
apiKey: "sk-abv-...",
baseUrl: "https://app.abv.dev", // US region
// baseUrl: "https://eu.app.abv.dev", // EU region
});
import { ABVClient } from "@abvdev/client";
import dotenv from "dotenv";
dotenv.config();
const abv = new ABVClient();
async function main() {
// Fetch list of traces, supports filters and pagination
const traces = await abv.api.trace.list();
// Fetch a single trace by ID
const trace = await abv.api.trace.get("traceId");
// Fetch list of observations, supports filters and pagination
const observations = await abv.api.observations.getMany();
// Fetch a single observation by ID
const observation = await abv.api.observations.get("observationId");
// Fetch list of sessions
const sessions = await abv.api.sessions.list();
// Fetch a single session by ID
const session = await abv.api.sessions.get("sessionId");
// Fetch list of scores
const scores = await abv.api.scoreV2.get();
// Fetch a single score by ID
const score = await abv.api.scoreV2.getById("scoreId");
// Explore more entities via Intellisense
}
fetchTraces()fetchTrace()fetchObservations()fetchObservation()fetchSessions()
