Organizations

The Organization is the top level element in the data structure. They are the data owner. They are the ones that have provided the data.

All entities/data in the system belong to one organization.

Get a list of organizations

get

/handball/organizations

Return a list of available organizations

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:

Query parameters

addedstring · date-timeOptional

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

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

countryCodestring · min: 3 · max: 3Optional

Country code

Example: USA

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

regionTypestring · enumOptional

The region type

INTERNATIONAL Multiple countries

LOCAL Local area

NATIONAL One country

STATE One state

Example: STATEPossible 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/organizations

GET /v1/handball/organizations 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": [
    {
      "organizationId": "b1a23",
      "abbreviationLocal": "NFA",
      "nameLocal": "Test name local",
      "abbreviationLatin": "NFA",
      "nameLatin": "Test name latin ",
      "countryCode": "USA",
      "regionType": "STATE",
      "defaultLocale": "fr-FR",
      "updated": "2026-01-08T13:43:56.669Z",
      "added": "2026-01-08T13:43:56.669Z",
      "images": [
        {
          "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": "2026-01-08T13:43:56.669Z",
          "added": "2026-01-08T13:43:56.669Z"
        }
      ]
    }
  ]
}

Create a new organization

post

/handball/organizations

Add a new organization to the system

Required scopes

This endpoint requires the following scopes:

: Ability to manage organizations

Authorizations

OAuth2clientCredentialsRequired

Token URL:

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

organizationIdstring · min: 5 · max: 5Optional

The unique identifier of the organization

Example: b1a23

abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: NFA

nameLocalstring · max: 150Required

The name of the organization in the local language

Example: Test name local

abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: NFA

nameLatinstring | nullableOptional

The name of the organization in latin characters

Example: Test name latin

countryCodestring | nullableOptional

Country code of the organization. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.

Example: USA

regionTypestring · enumRequired

How geographically relevant is this organization

INTERNATIONAL Multiple countries

INTERSTATE Cross state

LOCAL Local area

NATIONAL One country

STATE One state

Example: STATEPossible values:

defaultLocalestring · min: 5 · max: 5Optional

The locale of the video

Example: fr-FRPattern: ^[a-z]{2,2}-[A-Z]{2,2}$

Responses

200

Successful operation

application/json

default

Error

application/json

post

/handball/organizations

POST /v1/handball/organizations HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 204

{
  "organizationId": "b1a23",
  "abbreviationLocal": "NFA",
  "nameLocal": "Test name local",
  "abbreviationLatin": "NFA",
  "nameLatin": "Test name latin ",
  "countryCode": "USA",
  "regionType": "STATE",
  "defaultLocale": "fr-FR"
}

{
  "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": [
    {
      "organizationId": "b1a23",
      "abbreviationLocal": "NFA",
      "nameLocal": "Test name local",
      "abbreviationLatin": "NFA",
      "nameLatin": "Test name latin ",
      "countryCode": "USA",
      "regionType": "STATE",
      "defaultLocale": "fr-FR",
      "updated": "2026-01-08T13:43:56.669Z",
      "added": "2026-01-08T13:43:56.669Z",
      "images": [
        {
          "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": "2026-01-08T13:43:56.669Z",
          "added": "2026-01-08T13:43:56.669Z"
        }
      ]
    }
  ]
}

Get an organization

get

/handball/organizations/{organizationId}

Return detailed information about a specific 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

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/organizations/{organizationId}

GET /v1/handball/organizations/{organizationId} 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": [
    {
      "organizationId": "b1a23",
      "abbreviationLocal": "NFA",
      "nameLocal": "Test name local",
      "abbreviationLatin": "NFA",
      "nameLatin": "Test name latin ",
      "countryCode": "USA",
      "regionType": "STATE",
      "defaultLocale": "fr-FR",
      "updated": "2026-01-08T13:43:56.669Z",
      "added": "2026-01-08T13:43:56.669Z",
      "images": [
        {
          "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": "2026-01-08T13:43:56.669Z",
          "added": "2026-01-08T13:43:56.669Z"
        }
      ]
    }
  ]
}

Update an organization

put

/handball/organizations/{organizationId}

Change the information of a specific organization

Required scopes

This endpoint requires the following scopes:

: Ability to manage organizations

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

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

abbreviationLocalstring | nullableOptional

An abbreviation/short name in the local language

Example: NFA

nameLocalstring · max: 150Optional

The name of the organization in the local language

Example: Test name local

abbreviationLatinstring | nullableOptional

An abbreviation/short name in latin characters

Example: NFA

nameLatinstring | nullableOptional

The name of the organization in latin characters

Example: Test name latin

countryCodestring | nullableOptional

Country code of the organization. We recommend you use ISO-3166-1:alpha3 (upper case) values where available.

Example: USA

regionTypestring · enumOptional

How geographically relevant is this organization

INTERNATIONAL Multiple countries

INTERSTATE Cross state

LOCAL Local area

NATIONAL One country

STATE One state

Example: STATEPossible values:

defaultLocalestring · min: 5 · max: 5Optional

The locale of the video

Example: fr-FRPattern: ^[a-z]{2,2}-[A-Z]{2,2}$

Responses

200

Successful operation

application/json

default

Error

application/json

put

/handball/organizations/{organizationId}

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

{
  "abbreviationLocal": "NFA",
  "nameLocal": "Test name local",
  "abbreviationLatin": "NFA",
  "nameLatin": "Test name latin ",
  "countryCode": "USA",
  "regionType": "STATE",
  "defaultLocale": "fr-FR"
}

{
  "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": [
    {
      "organizationId": "b1a23",
      "abbreviationLocal": "NFA",
      "nameLocal": "Test name local",
      "abbreviationLatin": "NFA",
      "nameLatin": "Test name latin ",
      "countryCode": "USA",
      "regionType": "STATE",
      "defaultLocale": "fr-FR",
      "updated": "2026-01-08T13:43:56.669Z",
      "added": "2026-01-08T13:43:56.669Z",
      "images": [
        {
          "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": "2026-01-08T13:43:56.669Z",
          "added": "2026-01-08T13:43:56.669Z"
        }
      ]
    }
  ]
}

Delete an organization

delete

/handball/organizations/{organizationId}

Delete an organization

Required scopes

This endpoint requires the following scopes:

: Ability to manage organizations

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

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

Responses

200

Successful operation

application/json

default

Error

application/json

delete

/handball/organizations/{organizationId}

DELETE /v1/handball/organizations/{organizationId} 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": [
    {
      "organizationId": "b1a23",
      "abbreviationLocal": "NFA",
      "nameLocal": "Test name local",
      "abbreviationLatin": "NFA",
      "nameLatin": "Test name latin ",
      "countryCode": "USA",
      "regionType": "STATE",
      "defaultLocale": "fr-FR",
      "updated": "2026-01-08T13:43:56.669Z",
      "added": "2026-01-08T13:43:56.669Z",
      "images": [
        {
          "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": "2026-01-08T13:43:56.669Z",
          "added": "2026-01-08T13:43:56.669Z"
        }
      ]
    }
  ]
}

PreviousLeagues NextRoles

Last updated 3 minutes ago

Was this helpful?

Good afternoon

Get a list of organizations

Create a new organization

Get an organization

Update an organization

Delete an organization