📢 The Ask AI can now translate any part of the docs to your preferred language!
Read the guide
sportradar.comSportradar Support Portal

Video Stream Subscriptions

These endpoints allow a user to subscribe to a video feed. In subscribing to the feed they either:

  • - provide a URL where the video is to be sent (in the case of RTMP)

  • - receive a URL where the video can be consumed (in the case of HLS)

A content of PROGRAM is needed to use any setup video overlay.

List video stream subscriptions

get
/icehockey/o/{organizationId}/video/streams/subscriptions

Display the list of video stream subscriptions for fixtures.

Required scopes
This endpoint requires the following scopes:
  • : Read any data from the organization down
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
Query parameters
addedstring · date-timeOptional

Record was added after this date/time. In UTC.

Example: 2018-08-16T02:10:48
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
fixtureIdstring · uuidOptional

The unique identifier of the fixture

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
fromTimeUTCstring · date-timeOptional

Where match start time (in UTC) >= this value

Example: 2018-08-16T18:00:00
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
onlyUpcomingbooleanOptional

Do not show data for completed matches and those older than 12 hours

Example: true
seasonIdstring · uuidOptional

The unique identifier of the season

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
toTimeUTCstring · date-timeOptional

Where match start time (in UTC) <= this value

Example: 2018-08-16T18:00:00
updatedstring · date-timeOptional

Record was modified after this date/time. In UTC.

Example: 2018-08-16T02:11:48
Responses
200

Successful operation

application/json
get
/icehockey/o/{organizationId}/video/streams/subscriptions
GET /v1/icehockey/o/{organizationId}/video/streams/subscriptions HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "subscriptionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "customerId": 1,
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "outputResolution": "720",
      "outputFormat": "RTMP",
      "streamName": "text",
      "subscriptionName": "text",
      "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
      "audio": "COMMENTARY",
      "content": "CLEAN",
      "muxRate": "1200000",
      "updated": "2025-11-19T06:31:23.668Z",
      "added": "2025-11-19T06:31:23.668Z"
    }
  ]
}

Subscribe to a video stream

post
/icehockey/o/{organizationId}/video/streams/subscriptions

Subscribe to an upcoming video stream. Any subscription must be in place a minimum of 1 hour before the scheduled start time.

Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Available scopes:
  • : Authenticate based on a specific OrganizationId
  • : Read data over multiple organizations using and *orggroup* code
  • : Write/Update any data from below the organization
  • : Read any data from the organization down
  • : Perform administration API calls
  • : Ability to manage organizations
  • : Perform system configuration API calls
Path parameters
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
Body
subscriptionIdstring · uuidOptional

The unique identifier of the video stream subscription

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
customerIdinteger · int32 | nullableOptional

Customer of the subscription

Example: 1
fixtureIdstring · uuidRequired

The unique identifier of the match

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
providerstring · max: 100Required

The code for the provider of the file

Example: Test Provider
localestring · min: 5 · max: 5Required

The locale of the video

Example: fr-FRPattern: ^[a-z]{2,2}-[A-Z]{2,2}$
sourceNumberinteger · int32Required

Unique identifier for the video source. This is unique for the provider/fixtureId/locale combination. Unless the provider is supplying multiple sources per fixture/locale then this is normally 1.

Default: 1Example: 1
feedTypestring · enum · max: 30Required

Type of video input

  • ADDITIONAL_ANGLE Additional angle
  • LOW_LATENCY Low Latency
  • PRIMARY Primary
Example: PRIMARYPossible values:
outputResolutionstring · enum · max: 30Required

The resolution that you want to receive the video in. This is only valid if outputFormat is RTMP. If outputFormat is not RTMP then the output resolution is the same as the input resolution. If specified the output resolution cannot be higher than the input resolution. You must have specific permission to chose anything other than 720p or 1080p.

  • 1080 1920x1080
  • 1080@50fps 1920x1080 50fps
  • 1080i50@10M SRT 1080i50@10M
  • 1080p25@10M SRT 1080p25@10M
  • 1080p50@10M SRT 1080p50@10M
  • 1280x720@2000k 1280x720@2000k
  • 1280x720@3000k 1280x720@3000k
  • 1280x720@3000k25fps 1280x720@3000k25fps
  • 1920x1080@4000k 1920x1080@4000k
  • 1920x1080@4000k25fps 1920x1080@4000k25fps
  • 1920x1080@4500k 1920x1080@4500k
  • 1920x1080@5000k30fps 1920x1080@5000k30fps
  • 2000 2000
  • 288 512x288
  • 640x320@850k 640x320@850k
  • 720 1280x720
  • DESKTOP_384x216@280k DESKTOP_384x216@280k
  • DESKTOP_512x288@500k DESKTOP_512x288@500k
  • DESKTOP_768x432@1000k DESKTOP_768x432@1000k
  • MOBILE_320x180@102k MOBILE_320x180@102k
  • MOBILE_320x180@102k_BUFFERED MOBILE_320x180@102k_BUFFERED
  • MOBILE_320x180@232k MOBILE_320x180@232k
  • MOBILE_320x180@232k_BUFFERED MOBILE_320x180@232k_BUFFERED
  • MOBILE_480x270@464k MOBILE_480x270@464k
  • MOBILE_480x270@464k_BUFFERED MOBILE_480x270@464k_BUFFERED
  • MOBILE_768x432@1000k MOBILE_768x432@1000k
  • MOBILE_768x432@1000k_BUFFERED MOBILE_768x432@1000k_BUFFERED
Example: 720Possible values:
outputFormatstring · enum · max: 30Required

The output format

  • HLS HLS
  • RTMP RTMP
  • RTMP_PULL RTMP Pull
  • SRT SRT
Example: RTMPPossible values:
streamNamestring · max: 250Optional

The name/stream key of the RTMP stream. This is an optional part of the RTMP url - not a text description.

Pattern: ^[0-9A-Za-z.:/&_?=\-;@]*$
subscriptionNamestring · max: 250Optional

The name of the subscription

outputURLstring · max: 200Optional

The URL to send the output to. Only valid if outputFormat is 'RTMP' or 'SRT'

Example: rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9Pattern: ^[0-9A-Za-z.:/&_?=\-;@]*$
audiostring · enum · max: 30Optional

Audio

  • AMBIENCE Only ambience / crowd noise
  • BOTH Both combined
  • BOTH_SPLIT_LR Both (Ambience left channel, Commentary right channel)
  • COMMENTARY Only commentary
Default: BOTHExample: COMMENTARYPossible values:
contentstring · enum · max: 30Required

Content of the stream

  • CLEAN Output signal is the same as the input signal
  • PROGRAM Score overlays and other enhancements have been added to the stream
Example: CLEANPossible values:
muxRateinteger · int32Optional

The muxRate of the stream. Required for SRT outputFormat only.

Example: 1200000
Responses
200

Successful operation

application/json
post
/icehockey/o/{organizationId}/video/streams/subscriptions
POST /v1/icehockey/o/{organizationId}/video/streams/subscriptions HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 436

{
  "subscriptionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "customerId": 1,
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "provider": "Test Provider",
  "locale": "fr-FR",
  "sourceNumber": 1,
  "feedType": "PRIMARY",
  "outputResolution": "720",
  "outputFormat": "RTMP",
  "streamName": "text",
  "subscriptionName": "text",
  "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
  "audio": "COMMENTARY",
  "content": "CLEAN",
  "muxRate": "1200000"
}
{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "subscriptionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "customerId": 1,
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "outputResolution": "720",
      "outputFormat": "RTMP",
      "streamName": "text",
      "subscriptionName": "text",
      "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
      "audio": "COMMENTARY",
      "content": "CLEAN",
      "muxRate": "1200000",
      "updated": "2025-11-19T06:31:23.668Z",
      "added": "2025-11-19T06:31:23.668Z"
    }
  ]
}

Get a video stream subscription

get
/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId}

Return detailed information about a specific video stream subscription.

Required scopes
This endpoint requires the following scopes:
  • : Read any data from the organization down
Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Path parameters
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
subscriptionIdstring · uuidRequired

The unique identifier of the video stream subscription

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
limitinteger · int32 · min: 1 · max: 1000Optional

The maximum number of records to return. See Pagination for more information.

Default: 10Example: 10
offsetinteger · int32Optional

The offset of the records. See Pagination for more information.

Example: 10
Responses
200

Successful operation

application/json
get
/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId}
GET /v1/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "subscriptionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "customerId": 1,
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "outputResolution": "720",
      "outputFormat": "RTMP",
      "streamName": "text",
      "subscriptionName": "text",
      "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
      "audio": "COMMENTARY",
      "content": "CLEAN",
      "muxRate": "1200000",
      "updated": "2025-11-19T06:31:23.668Z",
      "added": "2025-11-19T06:31:23.668Z"
    }
  ]
}

Update a video subscription

put
/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId}

Change the information of an existing video subscription

Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Available scopes:
  • : Authenticate based on a specific OrganizationId
  • : Read data over multiple organizations using and *orggroup* code
  • : Write/Update any data from below the organization
  • : Read any data from the organization down
  • : Perform administration API calls
  • : Ability to manage organizations
  • : Perform system configuration API calls
Path parameters
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
subscriptionIdstring · uuidRequired

The unique identifier of the video stream subscription

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
forceDeletebooleanOptional

Force a delete command to run and delete child records as well if there are existing records depending on the record.

Example: true
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
Body
customerIdinteger · int32 | nullableOptional

Customer of the subscription

Example: 1
fixtureIdstring · uuidOptional

The unique identifier of the match

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
providerstring · max: 100Optional

The code for the provider of the file

Example: Test Provider
localestring · min: 5 · max: 5Optional

The locale of the video

Example: fr-FRPattern: ^[a-z]{2,2}-[A-Z]{2,2}$
sourceNumberinteger · int32Optional

Unique identifier for the video source. This is unique for the provider/fixtureId/locale combination. Unless the provider is supplying multiple sources per fixture/locale then this is normally 1.

Default: 1Example: 1
feedTypestring · enum · max: 30Optional

Type of video input

  • ADDITIONAL_ANGLE Additional angle
  • LOW_LATENCY Low Latency
  • PRIMARY Primary
Example: PRIMARYPossible values:
outputResolutionstring · enum · max: 30Optional

The resolution that you want to receive the video in. This is only valid if outputFormat is RTMP. If outputFormat is not RTMP then the output resolution is the same as the input resolution. If specified the output resolution cannot be higher than the input resolution. You must have specific permission to chose anything other than 720p or 1080p.

  • 1080 1920x1080
  • 1080@50fps 1920x1080 50fps
  • 1080i50@10M SRT 1080i50@10M
  • 1080p25@10M SRT 1080p25@10M
  • 1080p50@10M SRT 1080p50@10M
  • 1280x720@2000k 1280x720@2000k
  • 1280x720@3000k 1280x720@3000k
  • 1280x720@3000k25fps 1280x720@3000k25fps
  • 1920x1080@4000k 1920x1080@4000k
  • 1920x1080@4000k25fps 1920x1080@4000k25fps
  • 1920x1080@4500k 1920x1080@4500k
  • 1920x1080@5000k30fps 1920x1080@5000k30fps
  • 2000 2000
  • 288 512x288
  • 640x320@850k 640x320@850k
  • 720 1280x720
  • DESKTOP_384x216@280k DESKTOP_384x216@280k
  • DESKTOP_512x288@500k DESKTOP_512x288@500k
  • DESKTOP_768x432@1000k DESKTOP_768x432@1000k
  • MOBILE_320x180@102k MOBILE_320x180@102k
  • MOBILE_320x180@102k_BUFFERED MOBILE_320x180@102k_BUFFERED
  • MOBILE_320x180@232k MOBILE_320x180@232k
  • MOBILE_320x180@232k_BUFFERED MOBILE_320x180@232k_BUFFERED
  • MOBILE_480x270@464k MOBILE_480x270@464k
  • MOBILE_480x270@464k_BUFFERED MOBILE_480x270@464k_BUFFERED
  • MOBILE_768x432@1000k MOBILE_768x432@1000k
  • MOBILE_768x432@1000k_BUFFERED MOBILE_768x432@1000k_BUFFERED
Example: 720Possible values:
outputFormatstring · enum · max: 30Optional

The output format

  • HLS HLS
  • RTMP RTMP
  • RTMP_PULL RTMP Pull
  • SRT SRT
Example: RTMPPossible values:
streamNamestring · max: 250Optional

The name/stream key of the RTMP stream. This is an optional part of the RTMP url - not a text description.

Pattern: ^[0-9A-Za-z.:/&_?=\-;@]*$
subscriptionNamestring · max: 250Optional

The name of the subscription

outputURLstring · max: 200Optional

The URL to send the output to. Only valid if outputFormat is 'RTMP' or 'SRT'

Example: rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9Pattern: ^[0-9A-Za-z.:/&_?=\-;@]*$
audiostring · enum · max: 30Optional

Audio

  • AMBIENCE Only ambience / crowd noise
  • BOTH Both combined
  • BOTH_SPLIT_LR Both (Ambience left channel, Commentary right channel)
  • COMMENTARY Only commentary
Default: BOTHExample: COMMENTARYPossible values:
contentstring · enum · max: 30Optional

Content of the stream

  • CLEAN Output signal is the same as the input signal
  • PROGRAM Score overlays and other enhancements have been added to the stream
Example: CLEANPossible values:
muxRateinteger · int32Optional

The muxRate of the stream. Required for SRT outputFormat only.

Example: 1200000
Responses
200

Successful operation

application/json
put
/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId}
PUT /v1/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 380

{
  "customerId": 1,
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "provider": "Test Provider",
  "locale": "fr-FR",
  "sourceNumber": 1,
  "feedType": "PRIMARY",
  "outputResolution": "720",
  "outputFormat": "RTMP",
  "streamName": "text",
  "subscriptionName": "text",
  "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
  "audio": "COMMENTARY",
  "content": "CLEAN",
  "muxRate": "1200000"
}
{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "subscriptionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "customerId": 1,
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "outputResolution": "720",
      "outputFormat": "RTMP",
      "streamName": "text",
      "subscriptionName": "text",
      "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
      "audio": "COMMENTARY",
      "content": "CLEAN",
      "muxRate": "1200000",
      "updated": "2025-11-19T06:31:23.668Z",
      "added": "2025-11-19T06:31:23.668Z"
    }
  ]
}

Delete a video stream subscription

delete
/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId}

Delete an existing subscription

Authorizations
OAuth2clientCredentialsRequired

You can create a JSON Web Token (JWT) using the token API call. Each token is given a set of scopes/permissions. Each endpoint has a scope/permission that it requires to run. If your token does not possess the correct scope then you will be unable to make the API call.

Token URL:
Available scopes:
  • : Authenticate based on a specific OrganizationId
  • : Read data over multiple organizations using and *orggroup* code
  • : Write/Update any data from below the organization
  • : Read any data from the organization down
  • : Perform administration API calls
  • : Ability to manage organizations
  • : Perform system configuration API calls
Path parameters
organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23
subscriptionIdstring · uuidRequired

The unique identifier of the video stream subscription

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
Query parameters
externalstringOptional

A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.

Example: entityId,personId
fieldsstringOptional

A comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.

Example: dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]
forceDeletebooleanOptional

Force a delete command to run and delete child records as well if there are existing records depending on the record.

Example: true
hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true
includestringOptional

A comma separated list of resource types to include. See Resource Inclusion for more information.

Example: organizations,fixtures,entities
Responses
200

Successful operation

application/json
delete
/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId}
DELETE /v1/icehockey/o/{organizationId}/video/streams/subscriptions/{subscriptionId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "subscriptionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "customerId": 1,
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "outputResolution": "720",
      "outputFormat": "RTMP",
      "streamName": "text",
      "subscriptionName": "text",
      "outputURL": "rtmp://rtmp-api.facebook.com:80/rtmp/?340ur0JHKJ0398hjkh387HKJD9",
      "audio": "COMMENTARY",
      "content": "CLEAN",
      "muxRate": "1200000",
      "updated": "2025-11-19T06:31:23.668Z",
      "added": "2025-11-19T06:31:23.668Z"
    }
  ]
}
PreviousConferences & DivisionsNextDownload Video

Last updated

Was this helpful?