Sports

Sports endpoints expose the structured metadata used to build sport pages: sports, leagues, teams, valid market archetypes, and sport-linked events. Schedule/provider ingestion is intentionally separate from this public discovery surface.

List sports

Public

GET/api/sports

Returns configured sports with league/team/event counts.

Query parameters

activebooleanqueryoptional
Filter by active flag.

Request

cURL

curl "https://api.majjha.fun/api/sports"

Response

200 OK

{
  "sports": [
    {
      "id": "sport_football",
      "slug": "football",
      "name": "Football",
      "league_count": 2,
      "team_count": 0,
      "event_count": 0,
      "active": true
    }
  ]
}

List sports (Gamma shape)

Public

GET/sports

Returns active sports as a bare array using the current Gamma SDK metadata shape. Native PredictMax sports envelopes remain under `/api/sports/*`.

Request

cURL

curl "https://api.majjha.fun/sports"

Response

200 OK

[
  {
    "id": 1198777767191350,
    "sport": "football",
    "image": "",
    "resolution": "Football",
    "ordering": "10",
    "tags": "football",
    "series": "football",
    "createdAt": "2026-06-25T10:30:00+00:00",
    "updatedAt": "2026-06-25T10:30:00+00:00"
  }
]

Get sport

Public

GET/api/sports/{slug}

Returns one sport by slug or id.

Path parameters

slugstringpathrequired
Sport slug, e.g. `football`.

Request

cURL

curl "https://api.majjha.fun/api/sports/{slug}"

Response

200 OK

{
  "sport": {
    "id": "sport_basketball",
    "slug": "basketball",
    "name": "Basketball",
    "league_count": 3,
    "team_count": 0,
    "event_count": 0
  }
}

List sport leagues

Public

GET/api/sports/{slug}/leagues

Returns leagues for a sport, such as NFL, NBA, MLB, NHL, EPL, ATP, or UFC.

Path parameters

slugstringpathrequired
Sport slug.

Query parameters

activebooleanqueryoptional
Filter by active flag.

Request

cURL

curl "https://api.majjha.fun/api/sports/{slug}/leagues"

Response

200 OK

{
  "leagues": [
    {
      "id": "league_nfl",
      "sport_slug": "football",
      "slug": "nfl",
      "name": "National Football League",
      "abbreviation": "NFL",
      "region": "US",
      "team_count": 0,
      "event_count": 0
    }
  ]
}

List sport teams

Public

GET/api/sports/{slug}/teams

Returns teams/entities for a sport, optionally scoped to a league.

Path parameters

slugstringpathrequired
Sport slug.

Query parameters

leaguestringqueryoptional
Optional league slug.
activebooleanqueryoptional
Filter by active flag.
limitintegerqueryoptionaldefault: 100
Page size. Max 250.

Request

cURL

curl "https://api.majjha.fun/api/sports/{slug}/teams"

Response

200 OK

{
  "teams": [
    {
      "id": "team_kc",
      "sport_slug": "football",
      "league_slug": "nfl",
      "slug": "kansas-city-chiefs",
      "name": "Kansas City Chiefs",
      "abbreviation": "KC",
      "event_count": 12
    }
  ]
}

List teams (Gamma shape)

Public

GET/teams

Returns active teams/entities as a bare array using the current Gamma SDK team shape.

Query parameters

limitintegerqueryoptionaldefault: 100
Page size. Max 250.
offsetintegerqueryoptionaldefault: 0
Offset into the filtered team list.
orderstringqueryoptionaldefault: name
Sort field. Supports `id`, `name`, `abbreviation`, `league`, `createdAt`, and `updatedAt` aliases.
ascendingbooleanqueryoptionaldefault: true
Sort ascending instead of descending.
leaguestring[]queryoptional
Optional repeated or comma-separated league slug/id/abbreviation filter.
namestring[]queryoptional
Optional repeated or comma-separated team name, short name, or alias filter.
abbreviationstring[]queryoptional
Optional repeated or comma-separated abbreviation filter.

Request

cURL

curl "https://api.majjha.fun/teams"

Response

200 OK

[
  {
    "id": 791259457354511,
    "name": "Kansas City Chiefs",
    "league": "nfl",
    "record": null,
    "logo": "https://example.com/kc.png",
    "abbreviation": "KC",
    "alias": "kansas-city-chiefs",
    "createdAt": "2026-06-25T10:30:00+00:00",
    "updatedAt": "2026-06-25T10:30:00+00:00",
    "providerId": 387180068435415,
    "color": "#E31837"
  }
]

Get team (Gamma shape)

Public

GET/teams/{id}

Returns one team/entity by id or slug using the current Gamma SDK team shape.

Path parameters

idstringpathrequired
Team id or slug.

Request

cURL

curl "https://api.majjha.fun/teams/{id}"

Response

200 OK

{
  "id": 791259457354511,
  "name": "Kansas City Chiefs",
  "league": "nfl",
  "record": null,
  "logo": "https://example.com/kc.png",
  "abbreviation": "KC",
  "alias": "kansas-city-chiefs",
  "createdAt": "2026-06-25T10:30:00+00:00",
  "updatedAt": "2026-06-25T10:30:00+00:00",
  "providerId": 387180068435415,
  "color": "#E31837"
}

→Compatibility alias: `/api/gamma/teams/{id}`.

List sport market types

Public

GET/api/sports/{slug}/market-types

Returns valid sport market archetypes such as game winner, spread, total, player prop, and future, with resolution-source templates.

Path parameters

slugstringpathrequired
Sport slug.

Query parameters

activebooleanqueryoptional
Filter by active flag.

Request

cURL

curl "https://api.majjha.fun/api/sports/{slug}/market-types"

Response

200 OK

{
  "market_types": [
    {
      "sport_slug": "football",
      "slug": "game-winner",
      "title": "Game winner",
      "resolution_source": "official final score / league result",
      "rules_template": "Resolve YES for the listed side if it wins the event outright."
    }
  ]
}

List sports market types (Gamma shape)

Public

GET/sports/market-types

Returns active sport market-type slugs in the current Gamma SDK response shape.

Request

cURL

curl "https://api.majjha.fun/sports/market-types"

Response

200 OK

{
  "marketTypes": ["game-winner", "spread", "total"]
}

List sport events

Public

GET/api/sports/{slug}/events

Returns sport-linked events with league, team, scheduled-start, provider, and market-type metadata.

Path parameters

slugstringpathrequired
Sport slug.

Query parameters

leaguestringqueryoptional
Optional league slug.
teamstringqueryoptional
Optional home/away team slug.
marketTypestringqueryoptional
Optional sport market type slug.
statusstringqueryoptional
Optional event status.
ACTIVECLOSEDRESOLVED
limitintegerqueryoptionaldefault: 50
Page size. Max 100.

Request

cURL

curl "https://api.majjha.fun/api/sports/{slug}/events"

Response

200 OK

{
  "events": [
    {
      "event_ticker": "NFL-KC-BUF-2026-09-12",
      "title": "Chiefs vs Bills",
      "sport_slug": "football",
      "league_slug": "nfl",
      "home_team_slug": "kansas-city-chiefs",
      "away_team_slug": "buffalo-bills",
      "market_type_slug": "game-winner",
      "scheduled_start": "2026-09-12T20:20:00Z",
      "resolution_source_url": "https://www.nfl.com/scores/"
    }
  ]
}

→Provider schedule ingestion writes these normalized rows through the admin sports import endpoint.

PreviousEvents Next Markets