---
title: "List active MLB players"
method: GET
path: "/v1/mlb/players"
tags: ["MLB"]
---

# List active MLB players

`GET /v1/mlb/players`

## Request

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

Returns all active MLB players (966 total). Positions, teams, and statuses are normalized from MLB Stats API and reconciled against ESPN for accuracy.

Filter by position and team to build DFS pools or lineup constraints without doing the normalization yourself.

**Tier access:** Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `position` 'SP' | 'RP' | 'C' | '1B' | '2B' | '3B' | 'SS' | 'OF' | 'DH'
- `team` string
- `status` 'active' | 'injured' | 'inactive'
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of MLB players

- object
  - `success` boolean
  - `endpoint` string
  - `total` integer
  - `count` integer
  - `offset` integer
  - `limit` integer
  - `data` MLBPlayer[]
    - `id` string, required: PlayCaller MLB player ID
    - `full_name` string, required
    - `first_name` string
    - `last_name` string
    - `position` 'SP' | 'RP' | 'C' | '1B' | '2B' | '3B' | 'SS' | 'OF' | 'DH', required
    - `team` string, required
    - `status` 'active' | 'injured' | 'inactive', required
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `401`: Missing or invalid API key
- `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)