Retrieve Scorecard scores
GET/api/v1/scorecards/:tag/scores
Returns latest scores for all entities in the Scorecard
Request
Path Parameters
Unique tag for the Scorecard
Query Parameters
Entity tag (x-cortex-tag)
Default value: 250
Number of results to return per page, between 1 and 1000. Default 250.
Default value: 0
Page number to return, 0-indexed. Default 0.
Responses
- 200
- 404
Scorecard scores
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
- RuleExemptionUserActor
- RuleExemptionApiActor
- API
- USER
- RuleExemptionUserActor
- RuleExemptionApiActor
- API
- USER
]
Array [
]
Array [
]
Array [
]
]
scorecardFilter
object
groups
object
Entity groups to include or exclude
CQL expression to apply as a filter
types
object
Entity types (e.g. SERVICE, DOMAIN, TEAM) to include or exclude
serviceScores
object[]
required
ruleExemptions
object[]
required
exemptionStatus
object
required
Date on which the exemption was approved or rejected. Null if the status is pending
handledBy
object
API key or person who requested, approved, or rejected the exemption
oneOf
Person who requested, approved or rejected the exemption
Email of the person who requested, approved or rejected the exemption
Name of the person who requested, approved or rejected the exemption
Api key used to request, approve or reject the exemption
Last 4 digits of the API key used to approve or reject the exemption
type
string
required
Possible values: [API
, USER
]
Last 4 digits of the API key used to approve or reject the exemption
Email of the person who requested, approved or rejected the exemption
Name of the person who requested, approved or rejected the exemption
Status of the exemption. Possible values are APPROVED, REJECTED, and PENDING
requestedBy
object
required
API key or person who requested, approved, or rejected the exemption
oneOf
Person who requested, approved or rejected the exemption
Email of the person who requested, approved or rejected the exemption
Name of the person who requested, approved or rejected the exemption
Api key used to request, approve or reject the exemption
Last 4 digits of the API key used to approve or reject the exemption
type
string
required
Possible values: [API
, USER
]
Last 4 digits of the API key used to approve or reject the exemption
Email of the person who requested, approved or rejected the exemption
Name of the person who requested, approved or rejected the exemption
CQL representation of the rule
Identifier of the rule
score
object
required
ladderLevels
object[]
required
level
object
Name of the level
Rank of the level where 1 is the highest
rules
object[]
required
summary
object
required
service
object
required
Not to be confused with owners. This refers to the x-cortex-groups field of the entity.
Unique, immutable, 18-character auto-generated identifier for the entity.
Human-readable name for the entity.
owners
object
required
Not to be confused with x-cortex-groups. These are the slugs of IdP or Cortex Managed Teams
individuals
object[]
required
Unique identifier for the entity. Corresponds to the x-cortex-tag field in the entity descriptor.
{
"scorecardFilter": {
"groups": {
"exclude": [
"string"
],
"include": [
"string"
]
},
"query": "string",
"types": {
"exclude": [
"string"
],
"include": [
"string"
]
}
},
"scorecardName": "string",
"scorecardTag": "string",
"serviceScores": [
{
"lastEvaluated": "2024-07-29T15:51:28.071Z",
"ruleExemptions": [
{
"endDate": "2024-07-29T15:51:28.071Z",
"exemptionStatus": {
"date": "2024-07-29T15:51:28.071Z",
"handledBy": {},
"status": "string"
},
"requestedBy": {},
"requestedDate": "2024-07-29T15:51:28.071Z",
"requestingReason": "string",
"ruleExpression": "string",
"ruleIdentifier": "string"
}
],
"score": {
"ladderLevels": [
{
"level": {
"name": "Bronze",
"number": 0
}
}
],
"rules": [
{
"error": "string",
"expression": "string",
"identifier": "string",
"score": 0
}
],
"summary": {
"percentage": 0,
"score": 0,
"totalPossibleScore": 0
}
},
"service": {
"groups": [
"string"
],
"id": "en2da8159dbeefb974",
"name": "My Favorite Entity",
"owners": {
"groups": [
"string"
],
"individuals": [
{
"description": "string",
"email": "string"
}
]
},
"tag": "my-favorite-entity"
}
}
]
}
Scorecard not found
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [INTEGRATION_MISSING
, INTEGRATION_UNREGISTERED
, INTEGRATION_UNSUPPORTED
, INTEGRATION_GRAPHQL_ERROR
, INTEGRATION_BAD_REQUEST
, INTEGRATION_UNAUTHORIZED
, INTEGRATION_FORBIDDEN
, INTEGRATION_NOT_FOUND
, INTEGRATION_UNPROCESSABLE_CONTENT
, INTEGRATION_RATE_LIMITED
, INTEGRATION_INTERNAL_ERROR
, INTEGRATION_NOT_IMPLEMENTED
, INTEGRATION_BAD_GATEWAY
, INTEGRATION_UNAVAILABLE
, INTEGRATION_GATEWAY_TIMEOUT
, INTEGRATION_TIMED_OUT
, INTEGRATION_CACHE_ERROR
, INTEGRATION_UNHANDLED_HTTP_ERROR
, INTEGRATION_UNHANDLED_EXCEPTION
, INTEGRATION_UNEXPECTED_ERROR
, ILLEGAL_ARGUMENT_ERROR
, BAD_REQUEST
, FORBIDDEN
, NOT_FOUND
, REQUEST_TIMEOUT
, CONFLICT
, UNHANDLED_EXCEPTION
, UNCATEGORIZED
, SERVICE_CREATOR
, UNKNOWN_HOST
]
{
"details": "string",
"gatewayHttpStatus": 0,
"httpStatus": 0,
"message": "string",
"requestId": "string",
"type": "INTEGRATION_MISSING"
}