v61

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

List Scorecard Services

Lists services targeted by a scorecard.

get/v1/scorecards/{id}/catalog-services

Query parameters

page[size]integer
Example:10

The maximum number of items to include per page. The last page of a collection may include fewer items.

page[number]integer
Example:1

Determines which page of the entities to retrieve.

Filters a collection of services targeted by a scorecard.

{
  "custom_fields": 21,
  "created_at": {
    "eq": "2022-03-30T07:20:50Z"
  },
  "updated_at": {
    "eq": "2022-03-30T07:20:50Z"
  },
  "score.raw_value": 21
}
sortstring

The asc suffix is optional as the default sort order is ascending. The desc suffix is used to specify a descending order. Multiple sort attributes may be provided via a comma separated list. JSONPath notation may be used to specify a sub-attribute (eg: 'foo.bar desc').

Example:created_at desc

Sorts a collection of services targeted by a scorecard. Supported sort attributes are:

  • display_name
  • name
  • score.value
  • score.raw_value

Default sort is display_name in ascending order.

Response

A paginated list response for a collection of services targeted by a scorecard.

Example response

{
  "meta": {
    "page": {
      "number": 1,
      "size": 10,
      "total": 100
    }
  },
  "data": [
    {
      "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",
      "score": {
        "value": "88%",
        "raw_value": 87.5
      }
    }
  ]
}