---
title: "CRM v2 pipeline headline metrics, pendingReview archive-inclusive"
method: GET
path: "/funnel/v2/metrics"
tags: ["Analytics"]
---

# CRM v2 pipeline headline metrics, pendingReview archive-inclusive

`GET /funnel/v2/metrics`

The headline metrics above the Sample Requests board: `pendingReview` (count plus how many expire soon), `approvedInAutoProcess` (count with period-over-period `changePct` and `changeDirection`), `completionRate`, and `approvalTarget` progress against the shop's sample-approval limit, with a `dataFreshness` stamp.

`pendingReview.count` INCLUDES requests hidden because the creator is archived, so it matches TikTok's Affiliate Center; `expiringSoon` and `completionRate` stay over the visible rows, which are the ones you can act on.

Accepts the same filters as `/funnel/v2/requests`. Single-shop, CRM v2 shops only.

## Query parameters

- `page` integer — Page number, 1-based.
- `page_size` integer — Rows per page (max 100).
- `status` string, nullable — Pipeline tab to filter to. One of: toReview, readyToShip, shipped, pendingContent, completed, cancelled.
- `product_ids` string, nullable — Comma-separated product IDs.
- `profile_ids` string, nullable — Comma-separated creator profile IDs.
- `automation_ids` string, nullable — Comma-separated automation IDs that sourced the request.
- `tags` string, nullable — Comma-separated CRM tags.
- `created_from` string, nullable — Earliest request date, YYYY-MM-DD (inclusive).
- `created_to` string, nullable — Latest request date, YYYY-MM-DD (inclusive).
- `search` string, nullable — Free-text search over creator handle / name.
- `sort_by` string — Sort field.
- `sort_direction` string — 'asc' or 'desc'.
- `exclude_rejected` boolean — Drop rejected requests.
- `show_archived` boolean — Return archived requests instead.
- `show_expiring` boolean — Only requests expiring soon.
- `min_post_rate` number, nullable
- `max_post_rate` number, nullable
- `min_pps_score` number, nullable
- `max_pps_score` number, nullable
- `min_avg_views` number, nullable
- `max_avg_views` number, nullable
- `min_engagement_rate` number, nullable
- `max_engagement_rate` number, nullable
- `min_live_gmv` number, nullable
- `max_live_gmv` number, nullable
- `min_shop_gmv` number, nullable
- `max_shop_gmv` number, nullable
- `min_creator_gmv` number, nullable
- `max_creator_gmv` number, nullable
- `min_avg_gmv_video` number, nullable
- `max_avg_gmv_video` number, nullable
- `min_gmv_sample` number, nullable
- `max_gmv_sample` number, nullable
- `min_videos_per_sample` number, nullable
- `max_videos_per_sample` number, nullable

## Response `200`

Successful Response

- MetricsResponse
  - `pendingReview` PendingReviewMetric, required
    - `count` integer, required
    - `expiringSoon` integer, required
  - `approvedInAutoProcess` ChangeMetric, required
    - `count` integer, required
    - `changePct` number, required
    - `changeDirection` 'up' | 'down' | 'flat', required
  - `completionRate` CompletionRateMetric, required
    - `rate` number, required
    - `changePct` number, required
    - `changeDirection` 'up' | 'down' | 'flat', required
  - `approvalTarget` ApprovalTargetMetric, required
    - `monthlyLimit` integer, nullable
    - `monthlyUsed` integer, required
    - `dailyTarget` integer, nullable
    - `dailyCurrent` integer, required
    - `dailyPct` number, required
    - `onTrack` boolean, required
  - `dataFreshness` DataFreshness
    - `lastSyncedAt` string, nullable
    - `isStale` boolean
    - `isRefreshing` boolean
  - `notScopableBySku` string[]

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `578c830ce294` — 1 info
  - added the optional property `notScopableBySku` to the response with the `200` status

[Change history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/funnel/v2/metrics/get.md)

---

[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/643422c93bd8/schema)