---
title: "The current score for a target split up into the scoring components, depending on the defined perspective."
method: GET
path: "/public/v1/target/{systemId}/{targetId}/score-components"
tags: ["Scores - Target"]
deprecated: true
---

# The current score for a target split up into the scoring components, depending on the defined perspective.

`GET /public/v1/target/{systemId}/{targetId}/score-components`

> **Deprecated.**

⚠️ **DEPRECATED** - This endpoint is deprecated and will be removed at the end of December 2026.

**Note**: Responses include a `Sunset` HTTP header (RFC 8594) indicating the removal date.

---

## Migration Required

This endpoint has been deprecated in favor of the Enterprise Export API. Please migrate to the new endpoint:

### Replacement Endpoint

| Old Endpoint | New Endpoint | Purpose |
|--------------|--------------|---------|
| `GET /public/v1/target/{systemId}/{targetId}/score-components` | `GET /public/v1/enterprise-export/scores` | Retrieve score components |

---

## Why Migrate?

The Enterprise Export API (`PublicEnterpriseExportController`) provides:
- Score components and subcomponents when `includeComponents: true` is set in the configuration
- Bulk retrieval for multiple targets
- Automated scheduled exports
- Better performance for large-scale operations

---

## Quick Migration Guide

### Step 1: Configure Export Job with Components

Configure your export job to include components:

```json
{
  "runInterval": "DAILY",
  "enabled": true,
  "targetIds": [102006215],
  "perspectiveIds": [1],
  "includeComponents": true
}
```

### Step 2: Retrieve Score Components

Use `GET /public/v1/enterprise-export/scores` to retrieve score data with components:

```http
GET /public/v1/enterprise-export/scores?page=0&size=20
```

The response includes `components` and `subComponents` arrays when `includeComponents` is enabled.

---

## Current Endpoint Behavior

**Required Permission**: `ACCESS_PUBLIC_TARGET_SCORE`

**Performance impact**: Low

Returns the current score for a target split up into scoring components, including:
- Component type
- Component score
- List of subcomponents with their scores

Supports filtering by:
- Perspective ID (optional, defaults to user's perspective)
- Group ID (optional)

## Path parameters

- `systemId` string, required
- `targetId` string, required

## Query parameters

- `perspectiveId` integer
- `groupId` integer

## Response `200`

Target score components successfully retrieved

- PublicTargetScoreComponents[]
  - `component` 'PeerScore' | 'AlertScore' | 'SSAScore' | 'ExternalScore' | 'TierNScore' — Score component of the target
  - `score` PublicScore — Score of the target subcomponent
    - `value` integer, nullable — Score value
    - `risk` 'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical'
  - `subcomponents` PublicTargetScoreSubcomponent[], required — List of target score subcomponents
    - `subcomponent` 'CountryScore' | 'IndustryScore' | 'CommodityScore' | 'PublicAlertScore' | 'CustomerAlertScore' | 'InternalScore' | 'TierNIndustryScore' | 'TierNCommodityScore' | 'TargetScore', required — Score subcomponent of the target
    - `score` PublicScore — Score of the target subcomponent
      - `value` integer, nullable — Score value
      - `risk` 'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical'

## Other responses

- `403` — 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `404` — Target not found or no permission to access it
- `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)