For the complete documentation index, see llms.txt. This page is also available as Markdown.

GET Expected by Team

This endpoint allows you to get all the xG values we have available per team.

https://api.sportmonks.com/v3/football/expected/fixtures
{
  "data": [
    {
      "id": 26898369,
      "fixture_id": 18898173,
      "type_id": 5304,
      "participant_id": 10010,
      "data": {
        "value": 1.0674
      },
      "location": "home"
    },
    {
      "id": 26898370,
      "fixture_id": 18898173,
      "type_id": 5304,
      "participant_id": 7011,
      "data": {
        "value": 1.8234
      },
      "location": "away"
    },
Field
Description
Type

id

Refers to the unique id of the expected value.

integer

fixture_id

Refers to the fixture related to the value.

integer

type_id

Refers to the type of the Expected value.

integer

participant_id

Refers to the participant related to the Expected value.

integer

value

Displays the value.

integer

location

Refers to the location of the home or away team.

string

Query Parameters
Required?
Description

api_token

YES

Your unique API token

include

NO

Enrich the API with more data by using includes

select

NO

Select specific fields on the base entity.

filters

NO

Filter the API response on multiple related entities. There are static filters and dynamic filters.

Please find the possibilities in the Static and Dynamic Filter tab.

Not applicable for this endpoint.

The dynamic filters are based on entities and includes. Each dynamic filter uses an entity to filter on and one entity to apply the filter to. Below is an example with an explanation of how filters are set up. For more information, please look at our Filters page.

Using an include? Check their respective filters on their entity page. For example if you use &include=fixtures, you can apply fixture-related filters.

Dynamic Filters
Available on entity
Description
Examples

types

Statistics

Filter the statistics on a selection of type IDs separated by a comma.

&include=statistics&filters=fixtureStatisticTypes:TYPEIDS

&include=statistics&filters=fixtureStatisticTypes:42,49

Please note that the availability of xG values varies depending on the package you choose.

  • The Basic package offers access straight after the match has finished to all xG statistics.

  • The Advanced package offers real-time availability to all xG statistics.

You can find more information on our dedicated pricing page.

Pagination

Yes

Include depth

You can use a total of 3 nested includes on this endpoint

Include options

type fixture participant

Related Entities:

Get an overview and explanation of all the fields returned in the API response. The related entities for the expected endpoints are:

Run in Postman

Last updated

Was this helpful?