---
title: "Get MLB player by ID"
method: GET
path: "/v1/mlb/players/{id}"
tags: ["MLB"]
---

# Get MLB player by ID

`GET /v1/mlb/players/{id}`

## Request

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

Returns the full profile for a single MLB player by PlayCaller ID. Use `/v1/mlb/players?search=` to find IDs by name.

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

## Path parameters

- `id` string, required

## Response `200`

MLB player profile

- object
  - `success` boolean
  - `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
- `404`: Player not found
- `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)