---
title: "Shop performance targets"
method: GET
path: "/targets"
tags: ["Analytics"]
---

# Shop performance targets

`GET /targets`

The performance targets the shop is measured against — the goal values behind the dashboard's progress bars. Each target carries its `granularity` (weekly / monthly / quarterly), the period it applies from (`created_at`), and a `targets` object with the per-metric goals: `target_collabs`, `creators_messaged`, `sample_requests`, `sample_approved`, `videos_posted`, `videos_converted`, `spark_codes`.

Omit `granularity` to get the latest target for each granularity the shop has set; pass one to get that granularity's history, newest first. An empty `targets` array means the shop has not set any.

Read-only — targets are created and edited in the Reacher dashboard. Single-shop only.

## Query parameters

- `granularity` string, nullable — Restrict to one granularity: weekly, monthly, quarterly. Omit for the latest of each.

## Response `200`

Successful Response

- TargetsListResponse — Response model for listing targets
  - `targets` TargetResponse[], required — List of targets
    - `id` string, required — Target UUID
    - `customer_id` integer, required — Customer ID
    - `shop_id` integer, required — Shop ID
    - `granularity` string, required — Target time period granularity
    - `targets` TargetMetricsResponse, required — Nested model for target metrics in response payloads
      - `target_collabs` integer, nullable — Target number of collaborations
      - `creators_messaged` integer, nullable — Target number of creators messaged
      - `sample_requests` integer, nullable — Target number of sample requests
      - `videos_converted` integer, nullable — Target number of video conversions
      - `spark_codes` integer, nullable — Target number of spark codes
      - `sample_approved` integer, nullable — Target number of samples approved
      - `videos_posted` integer, nullable — Target number of videos posted
    - `created_at` string, date-time, required — When this target becomes applicable
    - `updated_at` string, date-time, required — Last update timestamp
  - `total_count` integer, required — Total number of targets

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)
