Get a subscription
curl --request GET \
--url https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id} \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id}"
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))
}const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"subscription": {
"id": "0192f1a0-0000-7000-8000-00000000c001",
"name": "orders-webhook",
"sink_kind": "webhook",
"endpoint_display": "https://hooks.example.com",
"signature_version": 1,
"plan_tier": "standard",
"enabled": true,
"verification_state": "pending_verification",
"credential_kind": "signing_secret",
"secret_configured": true,
"secret_rotated_at": "2026-01-15T12:00:00Z",
"secret_overlap_until": "2026-01-16T12:00:00Z",
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z",
"event_types": [
"account.created",
"account.updated"
],
"origin": "ledger",
"timeout_ms": 20000,
"schema_major": 1,
"event_majors": {},
"delegated_scope": "Rk9ORE8tQQ=="
}
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}Get a subscription
Returns one subscription scoped to the authenticated tenant. An absent, soft-deleted, or cross-tenant id returns a uniform 404 not_found (no existence oracle). The response never carries the signing secret. It carries endpoint_display, not the full destination; read that with GET /v1/subscriptions/{id}/endpoint.
GET
/
v1
/
subscriptions
/
{id}
Get a subscription
curl --request GET \
--url https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id} \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id}"
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))
}const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://streaming-hub.sandbox.lerian.net/v1/subscriptions/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"subscription": {
"id": "0192f1a0-0000-7000-8000-00000000c001",
"name": "orders-webhook",
"sink_kind": "webhook",
"endpoint_display": "https://hooks.example.com",
"signature_version": 1,
"plan_tier": "standard",
"enabled": true,
"verification_state": "pending_verification",
"credential_kind": "signing_secret",
"secret_configured": true,
"secret_rotated_at": "2026-01-15T12:00:00Z",
"secret_overlap_until": "2026-01-16T12:00:00Z",
"created_at": "2026-01-15T12:00:00Z",
"updated_at": "2026-01-15T12:00:00Z",
"event_types": [
"account.created",
"account.updated"
],
"origin": "ledger",
"timeout_ms": 20000,
"schema_major": 1,
"event_majors": {},
"delegated_scope": "Rk9ORE8tQQ=="
}
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}{
"title": "Not Found",
"status": 404,
"type": "https://errors.lerian.studio/v1/not_found",
"detail": "subscription not found",
"code": "not_found",
"instance": "4bf92f3577b34da6a3ce929d0e0e4736",
"errors": [
{
"location": "event_types/2",
"message": "\"transaction.creatd\" has no catalog entry at schema major 1"
}
]
}Autorizações
A bearer JWT issued by Access Manager. The /v1 surface never reads a tenant from the body, path, or query. Machine callers obtain a token with the Access Manager client-credentials flow. The /admin surface authorizes against an operator scope and carries no tenant context.
Parâmetros de caminho
The unique identifier of the subscription (UUIDv7).
Resposta
The subscription.
The non-secret projection of a subscription on the list and detail routes. It carries endpoint_display instead of the full destination, and never carries the signing secret or any credential material.
Show child attributes
Show child attributes
Esta página foi útil?