---
title: "Stat-threshold player filter (Growth+)"
method: GET
path: "/v1/players/filter"
tags: ["Multi"]
---

# Stat-threshold player filter (Growth+)

`GET /v1/players/filter`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/players/filter`
- Auth: API key in header `X-PlayCaller-Key`

Query players by stat thresholds (snap %, target share, fantasy points) against the most recent daily stat row per player. Whitelist-only query params.

**Tier access:** Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `position` string
- `team` string
- `sport` string
- `min_snap_pct` number
- `max_snap_pct` number
- `min_target_share` number
- `max_target_share` number
- `min_fantasy_pts` number
- `max_fantasy_pts` number
- `limit` integer

## Response `200`

Filtered players

- object
  - `success` boolean
  - `count` integer
  - `filters_applied` string[]
  - `data` object[]
    - `playcaller_id` string
    - `full_name` string
    - `position` string, nullable
    - `team` string, nullable
    - `sport_key` string
    - `snap_pct` number, nullable
    - `target_share` number, nullable
    - `fantasy_pts` number, nullable
    - `game_date` string, date, nullable

## Other responses

- `400`: A numeric filter param was not a valid number
- `401`: Missing or invalid API key
- `402`: Growth tier or higher required
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)