Usage notes

Code snippets

curl "https://api.oanor.com/mlb-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/mlb-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/mlb-api/v1/meta");
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/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "note": "Major League Baseball data. /v1/teams = the 30 clubs (filter league=AL|NL, division); /v1/standings?season=2025 = division standings (W-L, pct, games back, streak, run diff); /v1/schedule?date=YYYY-MM-DD&team=NYY = games & scores on a date (default today); /v1/roster?team=NYY = a team's roster; /v1/player?name=Aaron Judge or id=592450 (&season=&group=hitting|pitching) = bio + season stats; /v1/game?id=775296 = line score by gamePk. Teams resolve by abbreviation (NYY), id (147) or name. Official data from the MLB Stats API.",
        "source": "MLB Stats API (statsapi.mlb.com)",
        "endpoints": [
            "/v1/teams",
            "/v1/standings",
            "/v1/schedule",
            "/v1/roster",
            "/v1/player",
            "/v1/game",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:11.862Z",
        "request_id": "2b6e2596-a6a8-4d04-9edc-3779c1f425c1"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}