Skip to main content
GET
GET /v1/services/messagingServices/{id}

Retrieve a Messaging Service

Get a single messaging service by its unique ID or fully qualified name.

Get by ID

id
string
required
UUID of the messaging service to retrieve.
fields
string
Comma-separated list of fields to include. Valid fields: pipelines, owners, tags, domains, followers.
include
string
default:"non-deleted"
Include all, deleted, or non-deleted entities.

Get by Fully Qualified Name

Use GET /v1/services/messagingServices/name/{fqn} to retrieve by fully qualified name.
fqn
string
required
Fully qualified name of the messaging service (e.g., sample_kafka).
fields
string
Comma-separated list of fields to include. Valid fields: pipelines, owners, tags, domains, followers.
include
string
default:"non-deleted"
Include all, deleted, or non-deleted entities.
GET /v1/services/messagingServices/{id}

Returns

Returns a messaging service object with all requested fields populated.

Response

id
string
Unique identifier for the messaging service (UUID format).
name
string
Messaging service name.
fullyQualifiedName
string
Fully qualified name of the service.
displayName
string
Human-readable display name.
description
string
Description of the messaging service in Markdown format.
serviceType
string
Type of messaging service (e.g., Kafka, Redpanda, Kinesis).
connection
object
Connection configuration for the service.
version
number
Version number for the entity.
owners
array
List of owners. Only included when fields contains owners.
tags
array
Classification tags. Only included when fields contains tags.
domains
array
Domain assignments. Only included when fields contains domains.
followers
array
Users following this service. Only included when fields contains followers.
pipelines
array
Ingestion pipelines associated with this service. Only included when fields contains pipelines.

Error Handling