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

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

Return a list of streaming endpoints

Required scopes

This endpoint requires the following scopes:

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

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

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

GET /v1/football/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": "MANUAL",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2026-03-02T20:37:28.675Z",
      "added": "2026-03-02T20:37:28.675Z"
    }
  ]
}

Create a new local streaming endpoint record

post

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

Insert a new streamed endpoint video record

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2clientCredentialsRequired

Token URL:

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

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

Provider of the input

Example: MANUAL

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

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

POST /v1/football/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: 197

{
  "urlId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "provider": "MANUAL",
  "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": "MANUAL",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2026-03-02T20:37:28.675Z",
      "added": "2026-03-02T20:37:28.675Z"
    }
  ]
}

Get local video endpoint details

get

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

Return detailed information about a specific local streaming endpoint

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2clientCredentialsRequired

Token URL:

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

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

GET /v1/football/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": "MANUAL",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2026-03-02T20:37:28.675Z",
      "added": "2026-03-02T20:37:28.675Z"
    }
  ]
}

Update a local streaming endpoint

put

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

Change the information of a specific local streaming endpoint

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2clientCredentialsRequired

Token URL:

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

fixtureIdstring · uuidOptional

The unique identifier of the match

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

providerstring · max: 100Optional

Provider of the input

Example: MANUAL

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

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

PUT /v1/football/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: 150

{
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "provider": "MANUAL",
  "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": "MANUAL",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2026-03-02T20:37:28.675Z",
      "added": "2026-03-02T20:37:28.675Z"
    }
  ]
}

Delete a local streaming video endpoint

delete

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

Delete a specific streamed local video endpoint record

Required scopes

This endpoint requires the following scopes:

Authorizations

OAuth2clientCredentialsRequired

Token URL:

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

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

DELETE /v1/football/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": "MANUAL",
      "sourceNumber": 1,
      "format": "HLS",
      "url": "https://hls.host.com/video/index.m3u8",
      "updated": "2026-03-02T20:37:28.675Z",
      "added": "2026-03-02T20:37:28.675Z"
    }
  ]
}

PreviousPartner APIs NextLeader Qualifiers

Last updated 18 days ago

Was this helpful?

Good evening

hashtagGet a list of streaming endpoints

hashtagCreate a new local streaming endpoint record

hashtagGet local video endpoint details

hashtagUpdate a local streaming endpoint

hashtagDelete a local streaming video endpoint

Get a list of streaming endpoints

Create a new local streaming endpoint record

Get local video endpoint details

Update a local streaming endpoint

Delete a local streaming video endpoint