---
title: "Get forwarding endpoint status"
method: GET
path: "/v1beta1/telemetryrelay/endpoints/{ref.slug}:check"
tags: ["TelemetryRelayService"]
---

# Get forwarding endpoint status

`GET /v1beta1/telemetryrelay/endpoints/{ref.slug}:check`

Returns the last-known `ForwardingEndpointStatus` for a forwarding endpoint identified by `ref.slug`. This reads persisted state. It is not a live connectivity probe and does not verify TLS, authentication, or reachability against the destination. Live liveness checking is planned for a future release. The `zones_active` field in the response may be empty regardless of actual endpoint usage.

## Path parameters

- `ref.slug` string, required

## Response `200`

OK

- CoreweaveTelemetryrelaySvcClusterV1beta1CheckEndpointResponse
  - `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)