Skip to content
datasportsAPI

FixturesUmpires

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 26 of 116

Umpires

GET

/v2/fixtures/{id}/umpires

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
Umpire[]

Baseball only: the umpiring crew, giving each umpire’s name, years of experience and position (homePlate, firstBase, secondBase, thirdBase, leftField, rightField, other).

Worth knowing

Other sports, and games whose crew the source has not published, return 200 with an empty array; 404 is reserved for ids that do not exist.

01Parameters

  • idpathRequired

    fixture id issued by DataSportsAPI, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/umpires"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
Umpire[]
meta
count
ObjectsUmpire
Example response
{ "data": [ { "name": "Gabe Morales", "position": "homePlate", "experienceYears": 8 },
    { "name": "Nic Lentz", "position": "firstBase", "experienceYears": 5 }, … ],
  "meta": { "count": 6 } }

04Errors

  • 403history_not_in_plan

    the fixture predates the history your plan covers

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code