Video Stream Inputs

These set of endpoints list the video inputs available for a venue/organization/match. They would be used by the provider of the video to obtain the address/endpoints of where to send the content.

List available video inputs for a master venue

get

/handball/masterVenues/{masterVenueId}/video/streams/inputs

Display the list of video stream inputs for a master venue. This will only display inputs for matches in the future and from 12 hours in the past that have not been completed/cancelled.

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

masterVenueIdstring · uuidRequired

The unique identifier of the master venue

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

Query parameters

addedstring · date-timeOptional

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

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

competitionIdstring · uuidOptional

The unique identifier of the competition

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

externalstringOptional

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

Example: entityId,personId

feedTypestring · enum · max: 30Optional

Type of video input

ADDITIONAL_ANGLE Additional angle

LOW_LATENCY Low Latency

PRIMARY Primary

Example: PRIMARYPossible values:

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

fromTimeLocalstring · date-timeOptional

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

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

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

localestring · min: 5 · max: 5Optional

The locale of the video

Example: fr_FR

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

seasonIdstring · uuidOptional

The unique identifier of the season

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

sourceNumberinteger · int32Optional

Unique identifier for the video source

Example: 1

toTimeLocalstring · date-timeOptional

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

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

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

venueIdstring · uuidOptional

The unique identifier of the venue

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

Responses

200

Successful operation

application/json

default

Error

application/json

get

/handball/masterVenues/{masterVenueId}/video/streams/inputs

GET /v1/handball/masterVenues/{masterVenueId}/video/streams/inputs 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": [
    {
      "videoInputId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "masterVenueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "startTimeLocal": "2018-08-16T02:00:00",
      "startTimeUTC": "2018-08-16T02:00:00",
      "estimatedFinishTimeUTC": "2025-11-19T05:31:22.759Z",
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "inputResolution": "720",
      "fps": 25,
      "name": "text",
      "audioAmbienceChannel": "CHANNEL_BOTH",
      "audioCommentaryChannel": "CHANNEL_BOTH",
      "platformProviderOverride": "LOCAL",
      "inputURL": "rtmp://1ejcn5c-4wmytr5.vi.atriumsports.com/inputin1/inputin1",
      "streamName": "text",
      "updated": "2025-11-19T05:31:22.759Z",
      "added": "2025-11-19T05:31:22.759Z"
    }
  ]
}

List available video inputs for an organization

get

/handball/o/{organizationId}/video/streams/inputs

Display the list of video inputs for an organization. This will only display inputs for matches in the future and from 12 hours in the past that have not been completed/cancelled.

Authorizations

OAuth2clientCredentialsRequired

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

addedstring · date-timeOptional

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

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

competitionIdstring · uuidOptional

The unique identifier of the competition

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

externalstringOptional

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

Example: entityId,personId

feedTypestring · enum · max: 30Optional

Type of video input

ADDITIONAL_ANGLE Additional angle

LOW_LATENCY Low Latency

PRIMARY Primary

Example: PRIMARYPossible values:

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

fromTimeLocalstring · date-timeOptional

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

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

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

localestring · min: 5 · max: 5Optional

The locale of the video

Example: fr_FR

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

seasonIdstring · uuidOptional

The unique identifier of the season

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

sourceNumberinteger · int32Optional

Unique identifier for the video source

Example: 1

toTimeLocalstring · date-timeOptional

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

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

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

venueIdstring · uuidOptional

The unique identifier of the venue

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

videoInputIdstring · uuidOptional

The unique identifier of the video input record

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

Responses

200

Successful operation

application/json

default

Error

application/json

get

/handball/o/{organizationId}/video/streams/inputs

GET /v1/handball/o/{organizationId}/video/streams/inputs 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": [
    {
      "videoInputId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "masterVenueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "startTimeLocal": "2018-08-16T02:00:00",
      "startTimeUTC": "2018-08-16T02:00:00",
      "estimatedFinishTimeUTC": "2025-11-19T05:31:22.759Z",
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "inputResolution": "720",
      "fps": 25,
      "name": "text",
      "audioAmbienceChannel": "CHANNEL_BOTH",
      "audioCommentaryChannel": "CHANNEL_BOTH",
      "platformProviderOverride": "LOCAL",
      "inputURL": "rtmp://1ejcn5c-4wmytr5.vi.atriumsports.com/inputin1/inputin1",
      "streamName": "text",
      "updated": "2025-11-19T05:31:22.759Z",
      "added": "2025-11-19T05:31:22.759Z"
    }
  ]
}

List available video inputs for a match

get

/handball/o/{organizationId}/fixtures/{fixtureId}/video/streams/inputs

Display the list of video inputs for a match

Authorizations

OAuth2clientCredentialsRequired

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

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

feedTypestring · enum · max: 30Optional

Type of video input

ADDITIONAL_ANGLE Additional angle

LOW_LATENCY Low Latency

PRIMARY Primary

Example: PRIMARYPossible values:

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

localestring · min: 5 · max: 5Optional

The locale of the video

Example: fr_FR

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

videoInputIdstring · uuidOptional

The unique identifier of the video input record

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

Responses

200

Successful operation

application/json

default

Error

application/json

get

/handball/o/{organizationId}/fixtures/{fixtureId}/video/streams/inputs

GET /v1/handball/o/{organizationId}/fixtures/{fixtureId}/video/streams/inputs 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": [
    {
      "videoInputId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "masterVenueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "startTimeLocal": "2018-08-16T02:00:00",
      "startTimeUTC": "2018-08-16T02:00:00",
      "estimatedFinishTimeUTC": "2025-11-19T05:31:22.759Z",
      "provider": "Test Provider",
      "locale": "fr-FR",
      "sourceNumber": 1,
      "feedType": "PRIMARY",
      "inputResolution": "720",
      "fps": 25,
      "name": "text",
      "audioAmbienceChannel": "CHANNEL_BOTH",
      "audioCommentaryChannel": "CHANNEL_BOTH",
      "platformProviderOverride": "LOCAL",
      "inputURL": "rtmp://1ejcn5c-4wmytr5.vi.atriumsports.com/inputin1/inputin1",
      "streamName": "text",
      "updated": "2025-11-19T05:31:22.759Z",
      "added": "2025-11-19T05:31:22.759Z"
    }
  ]
}

PreviousMatch External PLAY BY PLAY NextVideo Streams Available

Last updated 1 hour ago

Was this helpful?

Good night

List available video inputs for a master venue

List available video inputs for an organization

List available video inputs for a match