v61

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-018131,3812.6 MB

Scorecards

Get a Catalog Service Scorecard

Fetches the given scorecard targeting the service.

get/v1/catalog-services/{serviceId}/scorecards/{scorecardId}

Response

A response containing a scorecard targeting a service.

idstring uuid required

namestring required

The human-readable name of the scorecard.

descriptionstring nullable required

scorecard_template'kong_best_practices' | 'service_documentation' | 'service_maturity' | 'security_and_compliance' nullable required

The name of the scorecard template used to create the scorecard. Otherwise, null.

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": "f3704e4c-104d-4f21-998a-20d4364c893f",
  "name": "Incident Response",
  "description": "Governs key metrics pertaining to teams' incident response practices.",
  "score": {
    "value": "88%",
    "raw_value": 87.5
  },
  "entity_selector": {
    "selector_parameters": {
      "resource_type": "gateway_svc",
      "integration": "gateway-manager"
    }
  },
  "scorecard_template": "kong_best_practices",
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z",
  "criteria": [
    {
      "id": "5c1121f9-3f3a-47c7-9bb6-c81a51128714",
      "name": "Time to restore service is less than 6 hours over the last 3 months.",
      "scorecard_id": "f3704e4c-104d-4f21-998a-20d4364c893f",
      "enabled": true,
      "template_name": "time_to_merge",
      "template_parameters": {
        "measure": "median",
        "threshold": {
          "unit": "hours",
          "value": 6
        },
        "window": {
          "unit": "months",
          "value": 3
        }
      },
      "section_name": "Documentation",
      "created_at": "2022-11-04T20:10:06.927Z",
      "updated_at": "2022-11-04T20:10:06.927Z",
      "evaluation": {
        "evaluation_context": {
          "raw_value": {
            "unit": "minutes",
            "value": 25
          },
          "display_text": "25 minutes"
        },
        "evaluation_error": {
          "type": "integration_unauthorized",
          "details": "The GitHub integration is unauthorized. Please ensure that the\nintegration is re-authorized for the criteria to be successfully evaluated.\n"
        },
        "attempted_at": "2023-02-15T07:20:50Z",
        "successfully_evaluated_at": "2023-02-15T07:20:50Z",
        "created_at": "2022-11-04T20:10:06.927Z"
      }
    }
  ]
}