v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB
Catalog Services

Get a Service

Fetches a service.

get/v1/catalog-services/{id}

Response

A response containing a single service object.

idstring uuid required

The service ID.

namestring required

The machine name of the Service that uniquely identifies it within the catalog.

display_namestring required

The display name of the Service.

descriptionstring nullable required

Optionally provide a description of the Service.

custom_fieldsCustomFields required

Map of customizable, catalog-defined fields providing information about a service.

labelsLabels required

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "id": "7f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
  "name": "user-svc",
  "display_name": "User Service",
  "custom_fields": {
    "owner": "John Appleseed",
    "dashboard": {
      "name": "On-Call Dashboard",
      "link": "https://my-dashboard-svc.io/dashboards/1"
    }
  },
  "labels": {
    "env": "test"
  },
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}