---
title: "Get OTLP destination by ID or name"
method: GET
path: "/telemetry/destinations/{id_or_name}"
tags: ["Browser Telemetry"]
---

# Get OTLP destination by ID or name

`GET /telemetry/destinations/{id_or_name}`

## Request

- Base URL: `https://api.onkernel.com`
- URL: `https://api.onkernel.com/telemetry/destinations/{id_or_name}`
- Auth: HTTP bearer

Retrieve a customer-visible OTLP destination in the authenticated organization by its ID or name. Project-scoped credentials can retrieve these destinations for selection by workloads in their project. Non-dashboard reads return header values redacted.

## Path parameters

- `id_or_name` string, required

## Response `200`

OTLP destination details

- OTLPDestination: An OTLP endpoint to export browser session telemetry to. Reference one from `telemetry.export.otlp.destination` when creating a browser to export that session's captured telemetry to it.
  - `consecutive_failures` integer, required: Failed deliveries since the last success, as observed by the relay process that wrote the latest outcome. Zero means the most recently recorded outcome succeeded.
  - `created_at` string, date-time, required
  - `description` string
  - `endpoint` string, required: OTLP/HTTP endpoint telemetry is sent to.
  - `headers` object, required: Headers sent with each export request. Names are returned in canonical form (`Authorization`, not `authorization`). Non-dashboard reads return values redacted as empty strings, so the keys are visible but the credentials are not. Dashboard reads return the stored values.
  - `id` string, required
  - `last_error` string: Sanitized class of the delivery failure recorded at `last_error_at`. It is retained after a later success, so its presence does not mean the destination is currently failing. Response bodies, endpoint URLs, credentials, and raw transport errors are never returned.
  - `last_error_at` string, date-time: Timestamp of the most recent failed delivery. It is retained after a later success, so it can predate `last_export_at`. Read `consecutive_failures` to tell whether the destination is currently failing.
  - `last_export_at` string, date-time: Timestamp of the most recent successful delivery. Moves only on success.
  - `name` string, required: Unique within the organization. Usable in place of the ID when selecting a destination, so it cannot be shaped like an ID.
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad Request – invalid input
- `401`: Unauthorized – missing or invalid authorization token
- `403`: Forbidden – insufficient permissions or plan
- `404`: Resource not found
- `500`: Internal Server Error

## Changes

- **2026-10-16** `03b369edee49`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kernel/apis/kernel-api/changes/telemetry/destinations/:id_or_name/get.md)

---

[API](https://skmtc.dev/kernel/apis/kernel-api.md) - [All operations](https://skmtc.dev/kernel/apis/kernel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kernel/apis/kernel-api/revisions/0f6cf4f58fe6?raw)