---
title: "Read Tracer Sessions Runs Metadata"
method: GET
path: "/api/v1/sessions/{session_id}/metadata"
tags: ["tracer-sessions"]
---

# Read Tracer Sessions Runs Metadata

`GET /api/v1/sessions/{session_id}/metadata`

Given a session, a number K, and (optionally) a list of metadata keys, return the top K values for each key.

## Path parameters

- `session_id` string, uuid, required

## Query parameters

- `metadata_keys` string[], nullable
- `start_time` string, date-time, nullable
- `k` integer
- `root_runs_only` boolean

## Response `200`

Successful Response

- RootModelDictStrListStr

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)