Images

An image can be assigned to different objects in the system.

Images can be assigned to an object by specifying the type of the object baseType and it's unique identifier baseId. For a person the baseId would be the value of the personId field for that person.

Images can also be assigned to an object based on a secondary type. For example you can assign an image to a person in a team. This means you can have an image for the person in general as well as an image for the person when they are playing for the team. This is accomplished by using the endpoints that support secondary types. In this instance the secondaryType would be ENTITY and the secondaryId the value of the ~~entityId~~.

Image Types

There are multiple different types of imageTypes. Some are valid for only certain baseTypes The image types are

LOGO (This type if valid for all objects except PERSON.) This is the logo of the organization.
LOGO_ALTERNATE (This type if valid for all objects except PERSON.) This is an alternate version of the logo. This may be better suited to a light/dark background as compared to the LOGO version.
LOGO_BACKGROUND (This type if valid for all objects except PERSON.) This is the logo of the organization in a format that can be used for background purposes. This would generally be a stylised version of the logo.
PERSON_HEAD (Only valid for the person type). This is a photo of a person from the shoulders up. This should include the shoulders.
PERSON_WAIST (Only valid for the person type). This is a photo of a person from the waist up.
PERSON_POSE (Only valid for the person type). This is a photo of a person where they are posing in some position. This could be a full body image or from the waist up.
TEAM_PHOTO (Only valid for the entity type). This is a photo of a team in a season.

Format

Images can be uploaded in any of the following formats:

images/jpeg
images/png

PNG files with an alpha channel are the preferred format.

File Size: Images can be a maxiumum of 2Mb in size

Dimensions: Images being uploaded should be square (eg 400x400) and be >= 100x100

Ratings

All images are given a rating when they are uploaded. All images are LOW by default but are set to MEDIUM if they are large enough and have an alpha channel/transparency. Images are only marked as HIGH if they have been manually reviewed.

Get a list of images

get

/handball/o/{organizationId}/images/for/{baseType}

Return a list of images for the type

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

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

hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true

imageTypestring · enum · max: 100Optional

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

ratingstring · enum · max: 100Optional

Media Rating

HIGH High

LOW Low

MEDIUM Medium

UNKNOWN Uknown

Example: UNKNOWNPossible values:

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

/handball/o/{organizationId}/images/for/{baseType}

GET /v1/handball/o/{organizationId}/images/for/{baseType} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Get a list of images for a fixture

get

/handball/o/{organizationId}/images/for/FIXTURE/{fixtureId}

Return a list of images for the fixture

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

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

addedstring · date-timeOptional

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

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

baseTypestring · enum · max: 100Optional

Base Type. Multiple allowed (comma-delimited).

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSON,ENTITYPossible values:

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

imageTypestring · enum · max: 100Optional

Upload Type. Multiple allowed (comma-delimited).

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGO,PERSON_HEADPossible values:

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

ratingstring · enum · max: 100Optional

Media Rating

HIGH High

LOW Low

MEDIUM Medium

UNKNOWN Uknown

Example: UNKNOWNPossible values:

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

/handball/o/{organizationId}/images/for/FIXTURE/{fixtureId}

GET /v1/handball/o/{organizationId}/images/for/FIXTURE/{fixtureId} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Get a list of images for the Organization

get

/handball/o/{organizationId}/images/for/ORGANIZATION

Return a list of images for the Organization

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

Authorizations

OAuth2clientCredentialsRequired

Token URL:

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

baseTypestring · enum · max: 100Optional

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Default: ORGANIZATIONExample: PERSONPossible values:

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

imageTypestring · enum · max: 100Optional

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

ratingstring · enum · max: 100Optional

Media Rating

HIGH High

LOW Low

MEDIUM Medium

UNKNOWN Uknown

Example: UNKNOWNPossible values:

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

/handball/o/{organizationId}/images/for/ORGANIZATION

GET /v1/handball/o/{organizationId}/images/for/ORGANIZATION 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Get a list of images for a specific type and id

get

/handball/o/{organizationId}/images/for/{baseType}/{baseId}

Return a list of images for the type and id

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseIdstring · uuidRequired

The unique identifier of the object associated with this record

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

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

hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true

imageTypestring · enum · max: 100Optional

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

ratingstring · enum · max: 100Optional

Media Rating

HIGH High

LOW Low

MEDIUM Medium

UNKNOWN Uknown

Example: UNKNOWNPossible values:

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

/handball/o/{organizationId}/images/for/{baseType}/{baseId}

GET /v1/handball/o/{organizationId}/images/for/{baseType}/{baseId} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Get a list of images for a type in a secondary Type

get

/handball/o/{organizationId}/images/for/{baseType}/in/{secondaryType}/{secondaryId}

Return a list of images assigned to type for a secondary type and Id

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

secondaryIdstring · uuidRequired

The unique identifier of the secondary object associated with this image record

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

secondaryTypestring · enum · max: 100Required

Media Secondary Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

SEASON Season

Example: ENTITYPossible values:

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

hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true

imageTypestring · enum · max: 100Optional

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

ratingstring · enum · max: 100Optional

Media Rating

HIGH High

LOW Low

MEDIUM Medium

UNKNOWN Uknown

Example: UNKNOWNPossible values:

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

/handball/o/{organizationId}/images/for/{baseType}/in/{secondaryType}/{secondaryId}

GET /v1/handball/o/{organizationId}/images/for/{baseType}/in/{secondaryType}/{secondaryId} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Get a list of images for a specific base and secondary id

get

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}

Return a list of images for the base id for a secondary id

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseIdstring · uuidRequired

The unique identifier of the object associated with this record

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

secondaryIdstring · uuidRequired

The unique identifier of the secondary object associated with this image record

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

secondaryTypestring · enum · max: 100Required

Media Secondary Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

SEASON Season

Example: ENTITYPossible values:

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

hideNullbooleanOptional

Don't display data fields with null values or empty structures

Example: true

imageTypestring · enum · max: 100Optional

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

ratingstring · enum · max: 100Optional

Media Rating

HIGH High

LOW Low

MEDIUM Medium

UNKNOWN Uknown

Example: UNKNOWNPossible values:

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

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}

GET /v1/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Get an image

get

/handball/o/{organizationId}/images/{imageId}

Return detailed information about a specific image

Required scopes

This endpoint requires the following scopes:

: Read any data from the organization down

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

imageIdstring · uuidRequired

The unique identifier of the image record

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

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

/handball/o/{organizationId}/images/{imageId}

GET /v1/handball/o/{organizationId}/images/{imageId} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Delete an image

delete

/handball/o/{organizationId}/images/{imageId}

Delete an image

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

imageIdstring · uuidRequired

The unique identifier of the image record

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

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

/handball/o/{organizationId}/images/{imageId}

DELETE /v1/handball/o/{organizationId}/images/{imageId} 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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Update the rating for an image

put

/handball/o/{organizationId}/images/{imageId}/rating

Set the rating for an image

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

imageIdstring · uuidRequired

The unique identifier of the image record

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

ratingstring · enum · max: 100Optional

The rating given to the quality of the image. All images are LOW by default but are set ad MEDIUM if they are large enough and have transparency. Images are only marked as HIGH if they have been manually reviewed. You should take your use-case into account when you go to use the image.

HIGH High

LOW Low

MEDIUM Medium

Example: LOWPossible values:

Responses

200

Successful operation

application/json

default

Error

application/json

put

/handball/o/{organizationId}/images/{imageId}/rating

PUT /v1/handball/o/{organizationId}/images/{imageId}/rating HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "rating": "LOW"
}

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Upload a new image

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}

You can upload the image in one of two ways:

A binary blob in the POST data
A 'file' field in a multipart/form-data

Binary Blob

Upload the image by supplying the image as binary in the POST data.

The HTTP request would look like

POST /v1/handball/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON_HEAD
Host: example.com
Authorization: Bearer some-token
Content-Length: 808
Content-Type: image/png

[file content goes there]

Multi-part form

Upload the image by supplying it as a 'file' field in a multipart form. The file field must be called filedata and the content-type must be set to multipart/form-data

Note: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseIdstring · uuidRequired

The unique identifier of the object associated with this record

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

imageTypestring · enum · max: 100Required

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

string · binaryOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}

POST /v1/handball/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Upload a new image from a URL

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}/fromURL

This method allows a new image to uploaded by providing a URL where the image can be downloaded from.

Note: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseIdstring · uuidRequired

The unique identifier of the object associated with this record

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

imageTypestring · enum · max: 100Required

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

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

urlstring · max: 250Required

The URL of the image

Example: http://www.example.com/images/image1.png

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}/fromURL

POST /v1/handball/o/{organizationId}/images/for/{baseType}/{baseId}/{imageType}/fromURL HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "url": "http://www.example.com/images/image1.png"
}

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Upload a new image in a secondary type

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}

Add a new image for a type in a secondary type. You can upload the image in one of two ways:

A binary blob in the POST data
A 'file' field in a multipart/form-data

Binary Blob

Upload the image by supplying the image as binary in the POST data.

The HTTP request would look like

POST /v1/handball/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON_HEAD
Host: example.com
Authorization: Bearer some-token
Content-Length: 808
Content-Type: image/png

[file content goes there]

Multi-part form

Upload the image by supplying it as a 'file' field in a multipart form. The file field must be called filedata and the content-type must be set to multipart/form-data

Note: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseIdstring · uuidRequired

The unique identifier of the object associated with this record

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

imageTypestring · enum · max: 100Required

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

secondaryIdstring · uuidRequired

The unique identifier of the secondary object associated with this image record

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

secondaryTypestring · enum · max: 100Required

Media Secondary Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

SEASON Season

Example: ENTITYPossible values:

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

string · binaryOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}

POST /v1/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Upload a new image in a secondary type from a URL

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}/fromURL

This method allows a new image to be uploaded against a secondary type by providing a URL where the image can be downloaded from.

Note: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

baseIdstring · uuidRequired

The unique identifier of the object associated with this record

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

baseTypestring · enum · max: 100Required

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: PERSONPossible values:

imageTypestring · enum · max: 100Required

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

secondaryIdstring · uuidRequired

The unique identifier of the secondary object associated with this image record

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

secondaryTypestring · enum · max: 100Required

Media Secondary Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

SEASON Season

Example: ENTITYPossible values:

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

urlstring · max: 250Required

The URL of the image

Example: http://www.example.com/images/image1.png

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}/fromURL

POST /v1/handball/o/{organizationId}/images/for/{baseType}/{baseId}/in/{secondaryType}/{secondaryId}/{imageType}/fromURL HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "url": "http://www.example.com/images/image1.png"
}

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Upload a new image for the organization

post

/handball/o/{organizationId}/images/for/ORGANIZATION/{imageType}

Add a new image for the organization. You can upload the image in one of two ways:

A binary blob in the POST data
A 'file' field in a multipart/form-data

Binary Blob

Upload the image by supplying the image as binary in the POST data.

The HTTP request would look like

POST /v1/handball/o/b1a23/images/for/PERSON/81814d2c-d640-11e8-9f8b-f2801f1b9fd1/PERSON_HEAD
Host: example.com
Authorization: Bearer some-token
Content-Length: 808
Content-Type: image/png

[file content goes there]

Multi-part form

Upload the image by supplying it as a 'file' field in a multipart form. The file field must be called filedata and the content-type must be set to multipart/form-data

Note: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

imageTypestring · enum · max: 100Required

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

Query parameters

baseTypestring · enum · max: 100Optional

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Default: ORGANIZATIONExample: PERSONPossible values:

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

string · binaryOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/o/{organizationId}/images/for/ORGANIZATION/{imageType}

POST /v1/handball/o/{organizationId}/images/for/ORGANIZATION/{imageType} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

Upload a new image for the organization from a URL

post

/handball/o/{organizationId}/images/for/ORGANIZATION/{imageType}/fromURL

This method allows a new image to be uploaded against the organization type by providing a URL where the image can be downloaded from.

Note: By uploading the image you confirm that you have the legal right to do so and to allow this image to be distributed.

Required scopes

This endpoint requires the following scopes:

: Write/Update any data from below the organization

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

imageTypestring · enum · max: 100Required

Upload Type

LOGO Logo

LOGO_ALTERNATE Logo - Alternate

LOGO_BACKGROUND Logo Background

PERSON_HEAD Head photo

PERSON_POSE Posing photo

PERSON_WAIST Waist and Head photo

TEAM_PHOTO Team Photo

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Example: LOGOPossible values:

organizationIdstring · min: 5 · max: 5Required

The unique identifier of the organization

Example: b1a23

Query parameters

baseTypestring · enum · max: 100Optional

Media Base Type

COMPETITION Competition

CONFERENCE Conference

DIVISION Division

ENTITY Entity

ENTITYGROUP Entity Group

LEAGUE League

ORGANIZATION Organization

PERSON Person

SEASON Season

UNIFORM Uniform

UNIFORM_ITEM Uniform Item

Default: ORGANIZATIONExample: PERSONPossible values:

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

urlstring · max: 250Required

The URL of the image

Example: http://www.example.com/images/image1.png

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/o/{organizationId}/images/for/ORGANIZATION/{imageType}/fromURL

POST /v1/handball/o/{organizationId}/images/for/ORGANIZATION/{imageType}/fromURL HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "url": "http://www.example.com/images/image1.png"
}

{
  "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": [
    {
      "imageId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "baseType": "entity",
      "baseId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fileType": "png",
      "imageType": "LOGO",
      "secondaryType": "entity",
      "secondaryId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "rating": "LOW",
      "url": "text",
      "maximumHeight": 200,
      "maximumWidth": 200,
      "updated": "2025-11-19T05:30:22.064Z",
      "added": "2025-11-19T05:30:22.064Z"
    }
  ]
}

PreviousDownload Video NextSeason Teams

Last updated 1 hour ago

Was this helpful?

Good night

Image Types

Format

Ratings

Get a list of images

Get a list of images for a fixture

Get a list of images for the Organization

Get a list of images for a specific type and id

Get a list of images for a type in a secondary Type

Get a list of images for a specific base and secondary id

Get an image

Delete an image

Update the rating for an image

Upload a new image

Upload a new image from a URL

Upload a new image in a secondary type

Upload a new image in a secondary type from a URL

Upload a new image for the organization

Upload a new image for the organization from a URL