---
title: "GET /v1/targets"
method: GET
path: "/v1/targets"
tags: ["targets"]
---

# GET /v1/targets

`GET /v1/targets`

## Request

- Base URL: `https://help.steep.app` (the document declares no server; this is the origin it was published from)
- URL: `https://help.steep.app/v1/targets`
- Auth: none declared

List available target series and their metrics for your workspace. Use for broader target series exploration, or filter by metric `identifier` if metrics of interest are already known.

## Query parameters

- `metricIdentifiers` string[]: Filter to targets for these exact `metric.identifier`s (Readable semantic model keys).

## Response `200`

Response for status 200

- object
  - `data` object[], required
    - `targetSeries` string, required
    - `metricIdentifier` string, required
    - `timeGrain` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly', required
    - `fromDate` string, required
    - `toDate` string, required
    - `rowCount` number, required
    - `dimensionValues` object, required: Map of dimension identifier to value for this target row. Keys are dimension identifiers (e.g. "country", "region"). Null when the target has no dimension breakdown.

## Other responses

- `401`: Response for status 401
- `403`: Response for status 403
- `422`: Response for status 422
- `429`: Response for status 429
- `500`: Response for status 500

---

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