Match Roster
A person can be rostered/selected to a specific match.
Return a list of persons in the roster for a match
- : Read any data from the organization down
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.
The unique identifier of the fixture
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the organization
b1a23Record was added after this date/time. In UTC.
2018-08-16T02:10:48A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Don't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesThe maximum number of records to return. See Pagination for more information.
10Example: 10The offset of the records. See Pagination for more information.
10Record was modified after this date/time. In UTC.
2018-08-16T02:11:48Successful operation
Error
GET /v1/icehockey/o/{organizationId}/fixtures/{fixtureId}/roster 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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Depending on the data, Add a new match roster entry or update an existing one
- : Write/Update any data from below the organization
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.
The unique identifier of the fixture
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the organization
b1a23A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Don't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesThe unique identifier of the match
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the team
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the person
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe number displayed on the jersey
34Playing position
GOALKEEPERDid person start the match on the court
trueThe Id of the data as set by the provider of the data
A123Pattern: ^[0-9A-Za-z/_-]+$Successful operation
Error
POST /v1/icehockey/o/{organizationId}/fixtures/{fixtureId}/roster HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 222
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123"
}{
"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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Get the roster for a team in a match
Return a list of persons in the roster for a team in a match
- : Read any data from the organization down
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.
The unique identifier of the entity
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the fixture
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the organization
b1a23Record was added after this date/time. In UTC.
2018-08-16T02:10:48A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Don't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesThe maximum number of records to return. See Pagination for more information.
10Example: 10The offset of the records. See Pagination for more information.
10Record was modified after this date/time. In UTC.
2018-08-16T02:11:48Successful operation
Error
GET /v1/icehockey/o/{organizationId}/fixtures/{fixtureId}/entities/{entityId}/roster 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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Get the roster information for a person in a match
Return the detailed roster information for a person in a match
- : Read any data from the organization down
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.
The unique identifier of the fixture
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the organization
b1a23The unique identifier of the person
009e9276-5c80-11e8-9c2d-fa7ae01bbebcA comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Don't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesThe maximum number of records to return. See Pagination for more information.
10Example: 10The offset of the records. See Pagination for more information.
10Successful operation
Error
GET /v1/icehockey/o/{organizationId}/fixtures/{fixtureId}/persons/{personId}/roster 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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Delete a match roster entry
Delete a specific match roster
- : Write/Update any data from below the organization
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.
The unique identifier of the fixture
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the organization
b1a23The unique identifier of the person
009e9276-5c80-11e8-9c2d-fa7ae01bbebcA comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Force a delete command to run and delete child records as well if there are existing records depending on the record.
trueDon't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesSuccessful operation
Error
DELETE /v1/icehockey/o/{organizationId}/fixtures/{fixtureId}/persons/{personId}/roster 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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Depending on the data, Add a new match roster entry or update an existing one, with fixtureId in the payload
- : Write/Update any data from below the organization
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.
The unique identifier of the organization
b1a23A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Don't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesThe unique identifier of the match
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the team
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the person
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe number displayed on the jersey
34Playing position
GOALKEEPERDid person start the match on the court
trueThe Id of the data as set by the provider of the data
A123Pattern: ^[0-9A-Za-z/_-]+$Successful operation
Error
POST /v1/icehockey/o/{organizationId}/fixtures/roster HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 222
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123"
}{
"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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Delete entire match roster
- : Write/Update any data from below the organization
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.
The unique identifier of the fixture
009e9276-5c80-11e8-9c2d-fa7ae01bbebcThe unique identifier of the organization
b1a23A comma separated list of fields that will instead be interpreted as an externalId. See External Ids for more information.
entityId,personIdA comma separated list of fields to display. The response will only display these fields. See Partial Response section for more information.
dob,firstName,organization(id),organizations[name], teams[name,details/metrics/*,tags(id)]Force a delete command to run and delete child records as well if there are existing records depending on the record.
trueDon't display data fields with null values or empty structures
trueA comma separated list of resource types to include. See Resource Inclusion for more information.
organizations,fixtures,entitiesSuccessful operation
Error
DELETE /v1/icehockey/o/{organizationId}/fixtures/{fixtureId}/persons/roster 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": [
{
"fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"fixture": {
"resourceType": "fixtures",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"organizationId": "9",
"organization": {
"resourceType": "organizations",
"id": "9"
},
"entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"entity": {
"resourceType": "entities",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
"person": {
"resourceType": "persons",
"id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
},
"bib": "34",
"position": "GOALKEEPER",
"starter": true,
"externalId": "A123",
"updated": "2025-11-19T06:11:27.249Z",
"added": "2025-11-19T06:11:27.249Z"
}
]
}Last updated
Was this helpful?