Season Person Base Statistics

Normally season statistics are built automatically based on match statistics. For some scenarios such as historical imports where the match level data is not available, that 'already aggregated' data can be imported into the base statistics. These will then be aggregated with the match generated statistics to create the competition and career statsitics.

Person season base statistics

get

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

/baseball/o/{organizationId}/statistics/base/for/person/in/seasons/{seasonId}

Return a list of person base statistics for a season

Required scopes

This endpoint requires the following scopes:

• : Read any data from the organization down

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

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

Query parameters

addedstring · date-timeOptional

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

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

competitorTypestring · enumOptional

The type of competitors in this fixture

• ENTITY Entity
• PERSON Person

Example: PERSONPossible values:

entityIdstring · uuidOptional

The unique identifier of the entity

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

externalstringOptional

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

Example: entityId,personId

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

fixtureTypestring · enum · max: 50Optional

Type of Fixture

• ALL_STAR All Star
• DEMONSTRATION Demonstration
• FINAL Final
• FRIENDLY Friendly
• PLAYOFF Playoff
• PRESEASON Pre Season
• REGULAR Regular

Example: REGULARPossible values:

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

personIdstring · uuidOptional

The unique identifier of the person

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

representingstring · max: 100Optional

Who the person was representing

Example: AUSTRALIA

representingCountrystring · enumOptional

What country representation is used

• ANY Any country
• NONE No country

Possible 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

/baseball/o/{organizationId}/statistics/base/for/person/in/seasons/{seasonId}

HTTPcURLJavaScriptPython

GET /v1/baseball/o/{organizationId}/statistics/base/for/person/in/seasons/{seasonId} 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureType": "REGULAR",
      "competitorType": "ENTITY",
      "representing": "AUSTRALIA",
      "statistics": {},
      "updated": "2026-03-03T00:23:26.992Z",
      "added": "2026-03-03T00:23:26.992Z"
    }
  ]
}

Delete season person base statistics

delete

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

/baseball/o/{organizationId}/statistics/base/for/person/in/seasons/{seasonId}

Delete a base statistic record for a person in a season.

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

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

Query parameters

competitorTypestring · enumOptional

The type of competitors in this fixture

• ENTITY Entity
• PERSON Person

Example: PERSONPossible values:

entityIdstring · uuidOptional

The unique identifier of the entity

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

externalstringOptional

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

Example: entityId,personId

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

fixtureTypestring · enum · max: 50Optional

Type of Fixture

• ALL_STAR All Star
• DEMONSTRATION Demonstration
• FINAL Final
• FRIENDLY Friendly
• PLAYOFF Playoff
• PRESEASON Pre Season
• REGULAR Regular

Example: REGULARPossible values:

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

personIdstring · uuidOptional

The unique identifier of the person

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

Responses

200

Successful operation

application/json

default

Error

application/json

delete

/baseball/o/{organizationId}/statistics/base/for/person/in/seasons/{seasonId}

HTTPcURLJavaScriptPython

DELETE /v1/baseball/o/{organizationId}/statistics/base/for/person/in/seasons/{seasonId} 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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureType": "REGULAR",
      "competitorType": "ENTITY",
      "representing": "AUSTRALIA",
      "statistics": {},
      "updated": "2026-03-03T00:23:26.992Z",
      "added": "2026-03-03T00:23:26.992Z"
    }
  ]
}

Create/Update season person base statistics

post

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

/baseball/o/{organizationId}/statistics/base/for/person/in/seasons

Depending on the data, add or update a base statistic record for a person in a season.

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

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

application/json

seasonIdstring · uuidRequired

The unique identifier of the season

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

personIdstring · uuidRequired

The unique identifier of the person

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

entityIdstring · uuidOptional

The unique identifier of the team

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

fixtureTypestring · enum · max: 50Required

Type of match

• ALL_STAR All Star
• DEMONSTRATION Demonstration
• FINAL Final
• FRIENDLY Friendly
• PLAYOFF Playoff
• PRESEASON Pre Season
• REGULAR Regular

Example: REGULARPossible values:

competitorTypestring · enum · max: 50Required

The type of competitors in this match

• ENTITY Entity
• PERSON Person

Example: ENTITYPossible values:

representingstring · max: 100Optional

Who was being represented for the season base statistics

Example: AUSTRALIA

statisticsobjectOptional

Responses

200

Successful operation

application/json

default

Error

application/json

post

/baseball/o/{organizationId}/statistics/base/for/person/in/seasons

HTTPcURLJavaScriptPython

POST /v1/baseball/o/{organizationId}/statistics/base/for/person/in/seasons HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 244

{
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "fixtureType": "REGULAR",
  "competitorType": "ENTITY",
  "representing": "AUSTRALIA",
  "statistics": {}
}

{
  "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": [
    {
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "fixtureType": "REGULAR",
      "competitorType": "ENTITY",
      "representing": "AUSTRALIA",
      "statistics": {},
      "updated": "2026-03-03T00:23:26.992Z",
      "added": "2026-03-03T00:23:26.992Z"
    }
  ]
}