Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/player

Player bio + season stats

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/mlb-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/mlb-api/v1/player" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/mlb-api/v1/player", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/mlb-api/v1/player");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/mlb-api/v1/player",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "stats": {
            "stat": {
                "age": 32,
                "avg": ".322",
                "obp": ".458",
                "ops": "1.159",
                "rbi": 144,
                "slg": ".701",
                "hits": 180,
                "runs": 122,
                "babip": ".367",
                "atBats": 559,
                "airOuts": 128,
                "doubles": 36,
                "triples": 1,
                "homeRuns": 58,
                "sacBunts": 0,
                "sacFlies": 2,
                "groundOuts": 82,
                "hitByPitch": 9,
                "leftOnBase": 238,
                "strikeOuts": 171,
                "totalBases": 392,
                "baseOnBalls": 133,
                "gamesPlayed": 158,
                "stolenBases": 10,
                "caughtStealing": 0,
                "numberOfPitches": 2885,
                "atBatsPerHomeRun": "9.64",
                "intentionalWalks": 20,
                "plateAppearances": 704,
                "groundOutsToAirouts": "0.64",
                "catchersInterference": 1,
                "groundIntoDoublePlay": 22,
                "stolenBasePercentage": "1.000",
                "caughtStealingPercentage": ".000"
            },
            "group": "hitting",
            "season": 2024,
            "has_stats": true
        },
        "player": {
            "id": 592450,
            "age": 34,
            "bats": "R",
            "last": "Judge",
            "name": "Aaron Judge",
            "team": null,
            "first": "Aaron",
            "active": true,
            "height": "6' 7\"",
            "throws": "R",
            "weight": 282,
            "position": "RF",
            "mlb_debut": "2016-08-13",
            "birth_city": "Linden",
            "birth_date": "1992-04-26",
            "birth_country": "USA",
            "primary_number": "99"
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:11.608Z",
        "request_id": "24a57476-a31e-4745-8a73-ba4d64391795"
    },
    "status": "ok",
    "message": "Player retrieved",
    "success": true
}