v61

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

Scorecards

List Scorecard Criteria Services

Lists services targeted by a scorecard criteria with evaluation results per-service.

get/v1/scorecards/{scorecardId}/criteria/{criteriaId}/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.

evaluation.is_passingboolean

Filter by a boolean value (true/false).

Filters a collection of services targeted by a scorecard criteria.

{
  "custom_fields": 21,
  "created_at": {
    "eq": "2022-03-30T07:20:50Z"
  },
  "updated_at": {
    "eq": "2022-03-30T07:20:50Z"
  },
  "evaluation.successfully_evaluated_at": {
    "eq": "2022-03-30T07:20:50Z"
  },
  "evaluation.attempted_at": {
    "eq": "2022-03-30T07:20:50Z"
  }
}

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 criteria. Supported sort attributes are:

display_name
name
evaluation.is_passing
evaluation.successfully_evaluated_at
evaluation.attempted_at

Default sort is display_name in ascending order.

Response

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

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": {
        "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"
      }
    }
  ]
}