Merge Records

These groups of calls allow the merging of multiple person or team records.

They would be used for example, if you find that the same person has been entered twice, but there are records/statistics assigned to both of them. By making this call the statistics and match records assigned to the duplicate person would be assigned to the original person.

The calls rewrite the statistics and data so instead of being assigned to fromPersonId/fromEntityId they are assigned to toPersonId/toEntityId. There is NO merging of data fields at the person/team level.

Merge two person records

post

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

/hockey/o/{organizationId}/persons/merge/from/{fromPersonId}/to/{toPersonId}

Merge the records of two persons

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

fromPersonIdstring · uuidRequired

The unique identifier of the 'from' record

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

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

toPersonIdstring · uuidRequired

The unique identifier of the 'to' record

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

object · mergepostbodyOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/hockey/o/{organizationId}/persons/merge/from/{fromPersonId}/to/{toPersonId}

HTTPcURLJavaScriptPython

POST /v1/hockey/o/{organizationId}/persons/merge/from/{fromPersonId}/to/{toPersonId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "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": [
    {
      "success": true
    }
  ]
}

For a given match, swap two person records

post

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

/hockey/o/{organizationId}/fixtures/{fixtureId}/persons/swap/from/{fromPersonId}/to/{toPersonId}

For a given match, swap the records of two persons

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

fromPersonIdstring · uuidRequired

The unique identifier of the 'from' record

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

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

toPersonIdstring · uuidRequired

The unique identifier of the 'to' record

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

object · mergepostbodyOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/hockey/o/{organizationId}/fixtures/{fixtureId}/persons/swap/from/{fromPersonId}/to/{toPersonId}

HTTPcURLJavaScriptPython

POST /v1/hockey/o/{organizationId}/fixtures/{fixtureId}/persons/swap/from/{fromPersonId}/to/{toPersonId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "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": [
    {
      "success": true
    }
  ]
}

For a given season, swap two team records

post

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

/hockey/o/{organizationId}/seasons/{seasonId}/entities/swap/from/{fromEntityId}/to/{toEntityId}

For a given season, swap the records of two teams

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

fromEntityIdstring · uuidRequired

The unique identifier of the 'from' record

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

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

seasonIdstring · uuidRequired

The unique identifier of the season

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

toEntityIdstring · uuidRequired

The unique identifier of the 'to' record

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

object · mergepostbodyOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/hockey/o/{organizationId}/seasons/{seasonId}/entities/swap/from/{fromEntityId}/to/{toEntityId}

HTTPcURLJavaScriptPython

POST /v1/hockey/o/{organizationId}/seasons/{seasonId}/entities/swap/from/{fromEntityId}/to/{toEntityId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "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": [
    {
      "success": true
    }
  ]
}

Merge two team records

post

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

/hockey/o/{organizationId}/entities/merge/from/{fromEntityId}/to/{toEntityId}

Merge the records of two teams

Required scopes

This endpoint requires the following scopes:

• : Write/Update any data from below the organization

Authorizations

OAuth2

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

fromEntityIdstring · uuidRequired

The unique identifier of the 'from' record

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

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

toEntityIdstring · uuidRequired

The unique identifier of the 'to' record

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

object · mergepostbodyOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/hockey/o/{organizationId}/entities/merge/from/{fromEntityId}/to/{toEntityId}

HTTPcURLJavaScriptPython

POST /v1/hockey/o/{organizationId}/entities/merge/from/{fromEntityId}/to/{toEntityId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "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": [
    {
      "success": true
    }
  ]
}

Move a season to a different competition

post

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

/hockey/o/{organizationId}/seasons/{seasonId}/move/from/competitions/{fromCompetitionId}/to/competitions/{toCompetitionId}

Move a season under a different competition

Required scopes

This endpoint requires the following scopes:

• : Perform administration API calls

Authorizations

OAuth2

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

fromCompetitionIdstring · uuidRequired

The unique identifier of the 'from' record

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

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

seasonIdstring · uuidRequired

The unique identifier of the season

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

toCompetitionIdstring · uuidRequired

The unique identifier of the 'to' record

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

object · mergepostbodyOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/hockey/o/{organizationId}/seasons/{seasonId}/move/from/competitions/{fromCompetitionId}/to/competitions/{toCompetitionId}

HTTPcURLJavaScriptPython

POST /v1/hockey/o/{organizationId}/seasons/{seasonId}/move/from/competitions/{fromCompetitionId}/to/competitions/{toCompetitionId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "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": [
    {
      "success": true
    }
  ]
}