Local Video Endpoints

Some video providers do not stream through Datacore and instead offer videos directly. These set of APIs allow the video provider to publish the endpoints that those videos will be available through.

These endpoints are only useful for providers of video content - not for consumers, these urls are available through normal subscription processes.

Get a list of streaming endpoints

get

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/basketball/o/{organizationId}/fixtures/{fixtureId}/video/streams/local

Return a list of streaming endpoints

Authorizations

OAuth2

Path parameters

fixtureIdstring · uuidRequired

The unique identifier of the fixture

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

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)]

formatstring · enum · max: 30Optional

The format of the video file

• HLS A HLS play list
• MP4 One MP4 file

Example: HLSPossible values:

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

providerstring · max: 100Optional

The unique code for the video provider

Example: Test Provider

sourceNumberinteger · int32Optional

Unique identifier for the video source

Example: 1

updatedstring · date-timeOptional

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

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

Responses

200

Successful operation

application/json

default

Error

application/json

get

/basketball/o/{organizationId}/fixtures/{fixtureId}/video/streams/local

HTTPcURLJavaScriptPython

GET /v1/basketball/o/{organizationId}/fixtures/{fixtureId}/video/streams/local 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": [
    {
      "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2025-11-11T23:40:10.362Z",
      "added": "2025-11-11T23:40:10.362Z"
    }
  ]
}

Create a new local streaming endpoint record

post

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/basketball/o/{organizationId}/fixtures/{fixtureId}/video/streams/local

Insert a new streamed endpoint video record

Authorizations

OAuth2

Path parameters

fixtureIdstring · uuidRequired

The unique identifier of the fixture

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

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

application/json

urlIdstring · uuidOptional

The unique identifier of the video

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

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

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

formatstring · enum · max: 30Optional

The format of the video file

• HLS A HLS play list
• MP4 One MP4 file

Example: HLSPossible values:

urlstring · max: 200Required

The URL where the file can be found

Example: https://hls.host.com/video/index.m3u8

Responses

200

Successful operation

application/json

default

Error

application/json

post

/basketball/o/{organizationId}/fixtures/{fixtureId}/video/streams/local

HTTPcURLJavaScriptPython

POST /v1/basketball/o/{organizationId}/fixtures/{fixtureId}/video/streams/local HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 204

{
  "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "provider": "Test Provider",
  "sourceNumber": 1,
  "format": "HLS",
  "url": "https://hls.host.com/video/index.m3u8"
}

{
  "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": [
    {
      "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2025-11-11T23:40:10.362Z",
      "added": "2025-11-11T23:40:10.362Z"
    }
  ]
}

Get local video endpoint details

get

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/basketball/o/{organizationId}/video/streams/local/{urlId}

Return detailed information about a specific local streaming endpoint

Authorizations

OAuth2

Path parameters

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

urlIdstring · uuidRequired

The unique identifier of the local stream video

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

default

Error

application/json

get

/basketball/o/{organizationId}/video/streams/local/{urlId}

HTTPcURLJavaScriptPython

GET /v1/basketball/o/{organizationId}/video/streams/local/{urlId} 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": [
    {
      "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2025-11-11T23:40:10.362Z",
      "added": "2025-11-11T23:40:10.362Z"
    }
  ]
}

Update a local streaming endpoint

put

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/basketball/o/{organizationId}/video/streams/local/{urlId}

Change the information of a specific local streaming endpoint

Authorizations

OAuth2

Path parameters

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

urlIdstring · uuidRequired

The unique identifier of the local stream video

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

Body

application/json

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

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

formatstring · enum · max: 30Optional

The format of the video file

• HLS A HLS play list
• MP4 One MP4 file

Example: HLSPossible values:

urlstring · max: 200Optional

The URL where the file can be found

Example: https://hls.host.com/video/index.m3u8

Responses

200

Successful operation

application/json

default

Error

application/json

put

/basketball/o/{organizationId}/video/streams/local/{urlId}

HTTPcURLJavaScriptPython

PUT /v1/basketball/o/{organizationId}/video/streams/local/{urlId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "provider": "Test Provider",
  "sourceNumber": 1,
  "format": "HLS",
  "url": "https://hls.host.com/video/index.m3u8"
}

{
  "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": [
    {
      "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2025-11-11T23:40:10.362Z",
      "added": "2025-11-11T23:40:10.362Z"
    }
  ]
}

Delete a local streaming video endpoint

delete

https://api.dc.connect.sportradar.com/v1https://api.dc.stg.connect-nonprod.sportradar.dev/v1

/basketball/o/{organizationId}/video/streams/local/{urlId}

Delete a specific streamed local video endpoint record

Authorizations

OAuth2

Path parameters

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

urlIdstring · uuidRequired

The unique identifier of the local stream video

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

default

Error

application/json

delete

/basketball/o/{organizationId}/video/streams/local/{urlId}

HTTPcURLJavaScriptPython

DELETE /v1/basketball/o/{organizationId}/video/streams/local/{urlId} 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": [
    {
      "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "provider": "Test Provider",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2025-11-11T23:40:10.362Z",
      "added": "2025-11-11T23:40:10.362Z"
    }
  ]
}