Fixture Management API

This page documents fixture-related external endpoints in Service Hub.

Authentication

All endpoints on this page require:

• USER_LOGIN_VALIDATION_POLICY
• JWT authentication (basic auth is not accepted for this policy)

See: API Authentication and Access

Base behavior

• All endpoints are GET.
• fixtureStartDate is optional.
• If fixtureStartDate is not provided, the server uses DateTime.UtcNow.Date.
• Successful responses return 200 OK with a JSON array (empty array when no data).
• Unhandled errors return a generic problem response.

Endpoints

Get fixtures by bot

• Route: GET /external/fixture/by-bot/{botId}
• Path params:
  • botId (int)
• Query params:
  • fixtureStartDate (DateTime?, optional)

Returns fixtures associated with a specific bot, filtered from the start date.

Get fixtures by venue

• Route: GET /external/fixture/by-venue/{venueId}
• Path params:
  • venueId (int)
• Query params:
  • fixtureStartDate (DateTime?, optional)

Returns fixtures for a Sportzcast venue id.

Get fixtures by genius venue

• Route: GET /external/fixture/by-genius-venue/{geniusVenueId}
• Path params:
  • geniusVenueId (int)
• Query params:
  • fixtureStartDate (DateTime?, optional)

Resolves geniusVenueId to an internal venue id, then returns fixtures for that venue. If the venue is not found, the endpoint returns 200 OK with an empty array.

Response shape (Fixture)

Each item in the array follows the fixture contract:

• id (int)
• geniusFixtureId (int)
• name (string?)
• sportId (int?)
• sportName (string?)
• competitionId (int?)
• competitionName (string?)
• eventStatusType (string?)
• createdDate (DateTime)
• updatedDate (DateTime?)
• fixtureStartTime (DateTime)
• fixtureEndTime (DateTime?)
• fixtureStatus (object?)
  • id (int)
  • name (string?)
• venue (object?)
  • id (int)
  • geniusId (int)
  • name (string?)
• isContentGraph (bool?)

Example request

GET /external/fixture/by-bot/12345?fixtureStartDate=2026-04-01
Authorization: Bearer <access_token>