Get forwarding endpoint status
curl --request GET \
--url https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": {
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"state": "FORWARDING_ENDPOINT_STATE_UNSPECIFIED",
"stateMessage": "<string>",
"zonesActive": [
{
"zoneSlug": "<string>",
"clusters": [
{
"id": "<string>"
}
]
}
],
"credentialsConfigured": true,
"credentialsUpdatedAt": "2023-11-07T05:31:56Z"
}
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Get forwarding endpoint status
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.
GET
/
v1beta1
/
telemetryrelay
/
endpoints
/
{ref.slug}
:check
Get forwarding endpoint status
curl --request GET \
--url https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coreweave.com/v1beta1/telemetryrelay/endpoints/{ref.slug}:check")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": {
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"state": "FORWARDING_ENDPOINT_STATE_UNSPECIFIED",
"stateMessage": "<string>",
"zonesActive": [
{
"zoneSlug": "<string>",
"clusters": [
{
"id": "<string>"
}
]
}
],
"credentialsConfigured": true,
"credentialsUpdatedAt": "2023-11-07T05:31:56Z"
}
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Authorizations
CoreWeave API access token sent as a bearer token.
Path Parameters
Response
OK
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.
Show child attributes
Show child attributes
Last modified on September 6, 2026
Was this page helpful?