---
title: "Returns the target score including the overall score and scores for all infotag-groups."
method: GET
path: "/public/v1/target/{systemId}/{targetId}/score"
tags: ["Scores - Target"]
deprecated: true
---

# Returns the target score including the overall score and scores for all infotag-groups.

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

## Request

- Base URL: `https://api.prewave.com`
- URL: `https://api.prewave.com/public/v1/target/{systemId}/{targetId}/score`
- Auth: API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/prewave/apis/public-prewave-api/docs/public/v1/target/:systemId/:targetId/score/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

⚠️ **DEPRECATED** - This endpoint is deprecated and will be removed on 31 May 2027.

**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` | `GET /public/v1/enterprise-export/scores` | Retrieve score data |

---

## Why Migrate?

The Enterprise Export API (`PublicEnterpriseExportController`) provides significant improvements:

### 1. Bulk Operations
- Retrieve scores for multiple targets in a single request
- More efficient for large-scale integrations

### 2. Automated Updates
- Configure scheduled exports that run automatically
- No need to poll individual endpoints

### 3. Better Performance
- Optimized for large-scale data retrieval
- Consistent data calculation timestamps

### 4. Error Handling
- Detailed error logs for failed calculations
- Better visibility into data quality issues

---

## Quick Migration Guide

### Step 1: Configure Export Job

Use `POST /public/v1/enterprise-export/scores/config` to set up your export configuration:

```json
{
  "runInterval": "DAILY",
  "enabled": true,
  "collectionIds": [123, 456],
  "targetIds": [102006215, 101641243],
  "perspectiveIds": [1, 2],
  "includeComponents": true
}
```

### Step 2: Retrieve Scores

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

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

The response includes all the same information as this endpoint, plus additional metadata:
- Calculation timestamps
- Risk levels
- Edge numbers for target identification

---

## Current Endpoint Behavior

**Required Permission**: `ACCESS_PUBLIC_TARGET_SCORE`

**Performance impact**: Low

Returns the target score including:
- Overall target score
- Scores for all infotag groups

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

## Path parameters

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

## Query parameters

- `perspectiveId` integer
- `groupId` integer
- `component` 'PeerScore' | 'AlertScore' | 'SSAScore' | 'ExternalScore' | 'TierNScore': Score component of the target
- `subcomponent` 'CountryScore' | 'IndustryScore' | 'CommodityScore' | 'PublicAlertScore' | 'CustomerAlertScore' | 'InternalScore' | 'TierNIndustryScore' | 'TierNCommodityScore' | 'TargetScore': Score subcomponent of the target

## Response `200`

Target score successfully retrieved

- PublicTargetScore
  - `score` PublicScore, required: Score of the target subcomponent
    - `value` integer, nullable: Score value
    - `risk` 'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical': Impact level.
  - `groups` PublicGroupScore[], required: List of group scores
    - `group` PublicInfotagGroup, required
      - `id` integer, required: Id of the infotag group
      - `name` string, required: Name of the infotag group
      - `sname` string, required: Short name/code of the infotag group
    - `score` PublicScore: Score of the target subcomponent
      - `value` integer, nullable: Score value
      - `risk` 'NA' | 'No' | 'Low' | 'Mid' | 'High' | 'Critical': Impact level.

## 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.

## Changes

- **2026-10-17** `cedf01f35c95`: 4 info
  - added `#/components/schemas/PublicLevel` to the `groups/items/score/allOf[#/components/schemas/PublicScore]/risk` response property `allOf` list for the response status `200`
  - added `#/components/schemas/PublicLevel` to the `score/risk` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/Level` from the `groups/items/score/allOf[#/components/schemas/PublicScore]/risk` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/Level` from the `score/risk` response property `allOf` list for the response status `200`

[Operation history](https://skmtc.dev/prewave/apis/public-prewave-api/changes/public/v1/target/:systemId/:targetId/score/get.md)

---

[API](https://skmtc.dev/prewave/apis/public-prewave-api.md) - [All operations](https://skmtc.dev/prewave/apis/public-prewave-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prewave/apis/public-prewave-api/revisions/8b6e3b3827ca?raw)