---
title: "List forwarding endpoints"
method: GET
path: "/v1beta1/telemetryrelay/endpoints"
tags: ["TelemetryRelayService"]
---

# List forwarding endpoints

`GET /v1beta1/telemetryrelay/endpoints`

Returns every forwarding endpoint in the caller's organization. Each endpoint is a destination that pipelines can target. Credentials are never returned in responses.

## Response `200`

OK

- CoreweaveTelemetryrelaySvcClusterV1beta1ListEndpointsResponse
  - `endpoints` CoreweaveTelemetryrelayTypesV1beta1ForwardingEndpoint[]
    - `ref` CoreweaveTelemetryrelayTypesV1beta1ForwardingEndpointRef, required — ForwardingEndpointRef uniquely identifies a forwarding endpoint within an organization. Endpoints are referenced by a human-readable slug that must be unique per organization.
      - `slug` string, required — slug is a unique identifier for the endpoint within the organization. Must be 3-32 characters, start with alphanumeric, and contain only alphanumeric and hyphens.
    - `spec` CoreweaveTelemetryrelayTypesV1beta1ForwardingEndpointSpec, required — Configuration for a forwarding endpoint. Includes a human-readable `displayName` and exactly one protocol-specific config. The protocol type is fixed at creation time and cannot be changed afterwards.
      - `displayName` string, required — display_name is a human-readable name for this endpoint. Used for display purposes in UIs and logs.
      - `https` CoreweaveTelemetryrelayTypesV1beta1HTTPSConfig — HTTPSConfig configures a generic HTTPS endpoint for custom integrations. Allows forwarding telemetry data to any HTTPS endpoint. Useful for custom receivers or third-party services. Authentication: If the endpoint requires HTTP Basic authentication, provide HTTPSCredentials when creating/updating the endpoint. If no credentials are provided, requests are sent without authentication.
        - `endpoint` string, required — endpoint is the URL of the HTTPS endpoint. Must be a valid HTTPS URL; plain HTTP is rejected. Targets that resolve to loopback, private, or link-local addresses are rejected by the service at submission time to prevent SSRF (see O11Y-2851).
        - `tls` CoreweaveTelemetryrelayTypesV1beta1TLSConfig — TLSConfig configures TLS settings for secure connections. Used when connecting to endpoints that require custom CA certificates or specific TLS configuration.
          - `certificateAuthorityData` string — certificate_authority_data contains the PEM-encoded CA certificate bundle. Must be base64-encoded when transmitted. If not provided, the system's default trust store is used.
    - `status` CoreweaveTelemetryrelayTypesV1beta1ForwardingEndpointStatus — ForwardingEndpointStatus reflects the current operational state of an endpoint. Status is managed by the system and includes connection state, timestamps, and information about which zones/clusters are actively using the endpoint.
      - `createdAt` string, date-time — created_at is when the endpoint was first created.
      - `updatedAt` string, date-time — updated_at is when the endpoint configuration was last modified.
      - `state` 'FORWARDING_ENDPOINT_STATE_PENDING' | 'FORWARDING_ENDPOINT_STATE_CONNECTED' | 'FORWARDING_ENDPOINT_STATE_ERROR', enum — Current operational state of the endpoint. `PENDING` while the endpoint is being provisioned, `CONNECTED` once the endpoint is operational and receiving data, `ERROR` when the endpoint encountered an error and is not operational.
      - `stateMessage` string — state_message provides additional context about the current state. Especially useful when state is ERROR to describe what went wrong.
      - `zonesActive` CoreweaveTelemetryrelayTypesV1beta1ForwardingEndpointStatusZoneClusterStatus[] — zones_active lists which zones and clusters are actively forwarding data to this endpoint.
        - `zoneSlug` string — zone_slug identifies the zone.
        - `clusters` CoreweaveTelemetryrelayTypesV1beta1ForwardingEndpointStatusClusterStatus[] — clusters is the list of clusters in this zone using the endpoint.
          - `id` string — id is the cluster's unique identifier.
      - `credentialsConfigured` boolean — credentials_configured indicates whether credentials have been set for this endpoint. Does not indicate if the credentials are valid, only that they exist.
      - `credentialsUpdatedAt` string, date-time — credentials_updated_at is when credentials were last set or updated. Unset if credentials have never been configured.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api.md) · [All operations](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coreweave/coreweave-telemetry-relay-api/revisions/3b98ea4fe0c3/schema)