Skip to content

/AWS1/IF_MDI=>SEARCHFIXTURES()

About SearchFixtures

Searches for the fixtures (sports events, such as a specific basketball game) that are available for a sport in a date window. Each fixture in the response includes a fixtureId that you specify in the clipping output of a feed, so that Elemental Inference maps the event data for that fixture onto the clipping metadata. This operation is paginated: if there are more fixtures than fit in one page, the response includes a nextToken that you pass in a subsequent request.

Method Signature

METHODS /AWS1/IF_MDI~SEARCHFIXTURES
  IMPORTING
    !IV_SPORT TYPE /AWS1/MDIDATASOURCESPORT OPTIONAL
    !IV_STARTDATE TYPE /AWS1/MDIFIXTUREDATE OPTIONAL
    !IV_ENDDATE TYPE /AWS1/MDIFIXTUREDATE OPTIONAL
    !IT_FILTERS TYPE /AWS1/CL_MDISEARCHFILTER=>TT_SEARCHFILTERLIST OPTIONAL
    !IV_MAXRESULTS TYPE /AWS1/MDIINTEGER OPTIONAL
    !IV_NEXTTOKEN TYPE /AWS1/MDISTRING OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_mdisearchfixturesrsp
  RAISING
    /AWS1/CX_MDIACCESSDENIEDEX
    /AWS1/CX_MDIGATEWAYTIMEDOUTEX
    /AWS1/CX_MDIINTSERVERERROREX
    /AWS1/CX_MDISERVICEUNAVAILEX
    /AWS1/CX_MDITOOMANYREQUESTEX
    /AWS1/CX_MDIVLDTNEXCEPTION
    /AWS1/CX_MDICLIENTEXC
    /AWS1/CX_MDISERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_sport TYPE /AWS1/MDIDATASOURCESPORT /AWS1/MDIDATASOURCESPORT

The sport to search for fixtures. Valid values: basketball (search for basketball fixtures), american-football (search for american-football fixtures).

iv_startdate TYPE /AWS1/MDIFIXTUREDATE /AWS1/MDIFIXTUREDATE

The first day of the search window, in UTC. The search includes fixtures that are scheduled on this day.

Specify the date in ISO 8601 format, as YYYY-MM-DD. For example, 2026-03-14.

Optional arguments:

iv_enddate TYPE /AWS1/MDIFIXTUREDATE /AWS1/MDIFIXTUREDATE

The last day of the search window, in UTC. The search includes fixtures that are scheduled on this day. Specify the date in ISO 8601 format, as YYYY-MM-DD.

If you omit this parameter, Elemental Inference searches only the day that you specified in startDate. The window from startDate through endDate must not exceed seven days.

it_filters TYPE /AWS1/CL_MDISEARCHFILTER=>TT_SEARCHFILTERLIST TT_SEARCHFILTERLIST

An array of filters that narrow the results. Each filter applies to one dimension of a fixture, such as the competitor. You can specify up to 10 filters.

A fixture must satisfy every filter in the array in order to appear in the results. Within one filter, a fixture must match at least one of the values.

iv_maxresults TYPE /AWS1/MDIINTEGER /AWS1/MDIINTEGER

The maximum number of fixtures to return for each API request.

The service might return fewer fixtures than the maxResults value. When more fixtures match the search, the response also includes a nextToken value that you can use to fetch the next batch of results.

iv_nexttoken TYPE /AWS1/MDISTRING /AWS1/MDISTRING

The token that identifies the batch of results that you want to see.

For example, you submit a SearchFixtures request with maxResults set at 5. The service returns the first batch of results (up to 5) and a nextToken value. To see the next batch of results, you submit the SearchFixtures request a second time, with the same search criteria, and specify the nextToken value.

RETURNING

oo_output TYPE REF TO /aws1/cl_mdisearchfixturesrsp /AWS1/CL_MDISEARCHFIXTURESRSP

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->searchfixtures(
  it_filters = VALUE /aws1/cl_mdisearchfilter=>tt_searchfilterlist(
    (
      new /aws1/cl_mdisearchfilter(
        it_values = VALUE /aws1/cl_mdifiltervaluelist_w=>tt_filtervaluelist(
          ( new /aws1/cl_mdifiltervaluelist_w( |string| ) )
        )
        iv_name = |string|
      )
    )
  )
  iv_enddate = |string|
  iv_maxresults = 123
  iv_nexttoken = |string|
  iv_sport = |string|
  iv_startdate = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_fixtures( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_fixtureid = lo_row_1->get_fixtureid( ).
      lv_string = lo_row_1->get_name( ).
      lv_string = lo_row_1->get_fixturegroup( ).
      lv_timestamp = lo_row_1->get_scheduledstart( ).
      lv_string = lo_row_1->get_status( ).
      LOOP AT lo_row_1->get_competitors( ) into lo_row_2.
        lo_row_3 = lo_row_2.
        IF lo_row_3 IS NOT INITIAL.
          lv_string = lo_row_3->get_name( ).
          lv_boolean = lo_row_3->get_ishome( ).
        ENDIF.
      ENDLOOP.
    ENDIF.
  ENDLOOP.
  lv_string = lo_result->get_nexttoken( ).
ENDIF.