Release Notes Schema Differences

Release Notes

▸ 2026-04-27

What's Changing?

When matches are sorted by score, or the score field is queried, and no other filters are active:

  • Default: Results are limited to the next 7 days.
  • POST state only: Results are limited to the past 7 days.
  • POST state + any other state: Results span from the past 7 days through the next 7 days.

A new h2hTeamIds filter has been added to MatchesFilter. It accepts an array of exactly 2 team IDs and restricts results to head-to-head matches between those teams. This filter is mutually exclusive with the teamIds filter.

The searchId query has been enhanced with the following changes:

  • All-language search: When no language argument is provided, the search now queries across all available languages in the translation tables instead of defaulting to a single language. This applies to TEAM, COMPETITION, and SPORT categories.
  • New optional filters added to SearchIdFilter:
    • age: AgeEnum — Filter results by age category (e.g. A_TEAM, U21, U19). Applies to TEAM and COMPETITION categories.
    • gender: GenderEnum — Filter results by gender (MALE, FEMALE, MIXED). Applies to TEAM and COMPETITION categories.

Example Queries

Search teams without language (all languages)

query {
    searchId(filter: {searchTerm: "Real Madrid", category: TEAM}) {
        ... on Team {
            id
            name
            ageName
            primaryColor
        }
    }
}

Search teams with age and gender filter

query {
    searchId(filter: {searchTerm: "Madrid", category: TEAM, language: DE_DE, age: A_TEAM, gender: MALE}) {
        ... on Team {
            id
            name
            ageName
            gender
        }
    }
}

▸ 2026-04-13

What's Changing?

Added new fields to the Standing type

  • rankDivision
  • rankConference
  • winPercentageDivision
  • winPercentageConference
  • streak
  • winDivision
  • lostDivision
  • drawDivision
  • winConference
  • lostConference
  • drawConference
  • gamesLive
  • winOnPenalty
  • lostOnPenalty
  • winOnExtraTime
  • lostOnExtraTime
  • winOnPenaltyAway
  • winOnPenaltyHome
  • lostOnPenaltyAway
  • lostOnPenaltyHome
  • winOnExtraTimeAway
  • winOnExtraTimeHome
  • lostOnExtraTimeAway
  • lostOnExtraTimeHome

▸ 2026-03-05

What's Changing?

  • Removed userId field form these types:
    • Application
    • BettingMarket
    • BettingMarketOutcome
    • Bonus
    • BonusType
    • Bookie
    • BookieCountrySubdivisionAssociation
    • Channel
    • Country
    • Currency
    • GoLink
    • PaymentType
    • Promotion
    • PromotionOddsBoost
    • PromotionOddsBoostMatchAssociation
    • PromotionOddsBoostMatchAssociationBettingMarketOutcomeAssociation
    • PromotionType
  • Removed comment field form these types: Bonus, MatchResult
  • Removed productOwnerUserId field form Application type

▸ 2026-02-27

What's Changing?

  • Added the uniqueId field to the Bet type. This field is unique for each bet.

▸ 2025-11-28

What's Changing?

  • Added the images field to the Sport type

▸ 2025-11-24

What's Changing?

  • Added the brandColor field of type ImageBrandColor to the Image type

▸ 2025-11-24

What's Changing?

  • Added the mandatory argument bookieId on BetFilter input type
  • Field matchMonth on Bet type is removed

▸ 2025-11-21

What's Changing?

  • Argument matchDate added to MatchesOrderBy input type. This argument allows to sort matches by match date.

▸ 2025-11-05

What's Changing?

HrefReplaced type added to the GoLink type. This type is used to retrieve the href of the link with replaced tracking parameters (when available).

Example Queries

query MyQuery {
    goLink(filter: {id: "1"}) {
        id
        href
        hrefReplaced(filter: {bookieIds: [2]}) {
            href
            affiliateId
            applicationId
            entityId
            entityType
            country
            countrySubdivisionCode
        }
    }
}

Result

{
  "data": {
    "goLink": {
      "id": "1",
      "href": "https://www.test.com/open-account?###affiliate_params###",
      "hrefReplaced": [
        {
          "href": "https://www.test.com/open-account?affiliate=case123",
          "affiliateId": "affiliate=case123",
          "applicationId": 1,
          "entityId": 2,
          "entityType": 'bookie',
          "country": null,
          "countrySubdivisionCode": null
        },
        {
          "href": "https://www.test.com/open-account?affiliate=case456",
          "affiliateId": "affiliate=case456",
          "applicationId": 1,
          "entityId": 2,
          "entityType": 'bookie',
          "country": "AT",
          "countrySubdivisionCode": null
        }
      ]
    }
  }
}

▸ 2025-11-03

What's Changing?

  • Field roundMarker on Round type now returns an array

▸ 2025-10-21

What's Changing?

  • Added root queries round and rounds
  • New RoundFilter and RoundsFilter are added
  • Old RoundFilter type renamed to the CompetitionRoundFilter
  • New arguments ids, seasonIds and currentMatchDays are added to the CompetitionRoundFilter with the same functionality as the old arguments
  • Old arguments id, seasonId and currentMatchDay in CompetitionRoundFilter will be deprecated
  • Argument ids is required without seasonIds on CompetitionRoundFilter
  • Matches can be filter based on the roundIds
  • MatchDay argument in Matches filter are also considering group_matchday
  • TeamPerson relation added to the Person type
  • New arguments added to the PersonsFilter

Remove Notice

The old arguments will be removed on November 18, 2025. After this date, queries using the deprecated arguments will no longer be supported.

Example Queries

Old Query (Deprecated)

query OldQuery($filter: RoundFilter!) {
    competitions {
        data {
            rounds(filter: $filter) {
                data {
                    id
                }
            }
        }
    }
}
{
"filter": {
    "id": ["1"],
    "currentMatchDay": [10],
    "seasonId": [10]
    }
}

New Query (Recommended)

query NewQuery($filter: CompetitionRoundFilter!) {
    competitions {
        data {
            rounds(filter: $filter) {
                data {
                    id
                }
            }
        }
    }
}
{
"filter": {
    "ids": ["1"],
    "currentMatchDays": [10],
    "seasonIds": [10]
    }
}

▸ 2025-10-13

What's Changing?

SerachId field is now available for application groups, channels, markets, persons, and sports. The SearchIdResult type is extended to support the new types.

▸ 2025-09-22

What's Changing?

  • The field differenceName will be replaced by differenceType in the Standing type.
  • The field differenceName is now nullable.

Remove Notice

The old field will be removed on October 27, 2025. After this date, queries using the deprecated types will no longer be supported.

Example Queries

Old Query (Deprecated)

query OldQuery {
    standings {
        data {
            id
            differenceName
        }
    }
}

New Query (Recommended)

query NewQuery {
    standings {
        data {
            id
            differenceType
        }
    }
}

▸ 2025-09-19

What's Changing?

The goLinks filters now use soft filtering. Soft Filtering means that if, for example, you filter by Country AT, you will get back both all AT goLinks and all globally available goLinks without a country restriction. Previously, globally defined goLinks were excluded when filtering by a specific country. The same behaviour also applies to the other mentioned soft filters.

The soft filter arguments are:

  • countries
  • countrySubdivisionCodes
  • languages
  • platforms
  • devices

▸ 2025-09-10

What's Changing?

The country argument in these filters is renamed to countries.

  • BetsFilter
  • MatchEntityBetsFilter

Remove Notice

The old argument will be removed on October 27, 2025. After this date, queries using the deprecated argument will no longer be supported.

Example Queries

Old Query (Deprecated)

query OldQuery {
  matches {
    data {
      id
      bets(filter: {
        bookieIds: 10, 
        country: [AT, DE] # Deprecated
        }) {
        data {
          id
        }
      }
    }
  }
}

New Query (Recommended)

query NewQuery {
  matches {
    data {
      id
      bets(filter: {
        bookieIds: 10, 
        countries: [AT, DE]
        }) {
        data {
          id
        }
      }
    }
  }
}

▸ 2025-09-04

What's Changing?

  • The competitionCollectionId argument in the MatchesFilter is replaced by competitionCollectionIds and now accepts arrays.

Remove Notice

The old argument will be removed on October 27, 2025. After this date, queries using the deprecated argument will no longer be supported.

Example Queries

Old Query (Deprecated)

query OldQuery {
    matches(filter: {competitionCollectionId: 2}) {
        data {
            id
            competitionId
        }
    }
}

New Query (Recommended)

query NewQuery {
    matches(filter: {competitionCollectionIds: [2]}) {
        data {
            id
            competitionId
        }
    }
}

▸ 2025-08-21

What's Changing?

  • Introduced the new goLink(s) root query and field type
  • Moving deepLinks filter to the goLinks
  • New type selection argument for the goLinks filter
  • Deprecating the deepLinks field in the bookie type
  • Deprecating some fields in the DeepLink type
  • Removing isFiltersFallbackActive from bookie.deepLink filter

Remove Notice

The deprecated fileds will be removed on October 27, 2025. After this date, queries using the deprecated fields will no longer be supported.

Example Queries

Old Query (Deprecated)

query OldQeury {
    bookies {
        data {
            id
            deepLinks(filter: {country: AT}) { #deprecated
                id #deprecated
                countries #deprecated
                urlPattern #deprecated
                isFillingBetSlip
                glue
            }
        }
    }
}

New Query (Recommended)

query NewQuery {
    bookies {
        data {
            id
            goLinks(filter: {countries: AT, types: [DEEP_LINK, MULTI_DEEP_LINK]}) {
                data {
                    id # same as deepLink id
                    countries # same as deepLink countries
                    href # same as deepLink urlPattern
                    deepLink {
                        isFillingBetSlip
                        glue
                    }
                }
            }
        }
    }
}