📢 The Ask AI can now translate any part of the docs to your preferred language!
Read the guide
sportradar.comSportradar Support Portal

Conduct

The Conduct record for an incident

Get a list of conduct

get
/football/o/{organizationId}/conduct

Return a list of available conduct records

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
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
competitionIdstring · uuidOptional

The unique identifier of the competition

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
conductStatusstring · enum | nullableOptional

Conduct status. Multiple allowed (comma-delimited).

  • None None
  • ACTIVE Active
  • CLOSED Closed
  • COMPLETE Complete
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
conductTypestring · enumOptional

Conduct type. Multiple allowed (comma-delimited).

  • CITATION Citation
  • CONCUSSION Concussion
  • CORRUPTION Corruption
  • DOPING Doping
  • FITNESS Fitness
  • MATCH_FIXING Match Fixing
  • MEDICAL Medical
  • NA_REQUEST National Association Request
  • SWEARING Swearing
  • TOUCHLINE_SUSPENSION Touchline Suspension
  • UNSPORTSMANLIKE_CONDUCT Unsportsmanlike Conduct
  • VIOLENT_CONDUCT Violent Conduct
Example: SWEARINGPossible values:
dateOffenceLocalEndstring · date-timeOptional

Where dateOffenceLocal is before this value

Example: 2018-08-16T18:00:00
dateOffenceLocalStartstring · date-timeOptional

Where dateOffenceLocal is after this value

Example: 2018-08-16T18:00:00
dateSuspendedFromEndstring · dateOptional

Where dateSuspendedFrom <= this value

Example: 2018-08-16
dateSuspendedFromStartstring · dateOptional

Where dateSuspendedFrom >= this value

Example: 2018-08-16
dateSuspendedToEndstring · dateOptional

Where dateSuspendedTo <= this value

Example: 2018-08-16
dateSuspendedToStartstring · dateOptional

Where dateSuspendedTo >= this value

Example: 2018-08-16
entityGroupIdstring · uuidOptional

The unique identifier of the entity group

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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)]
fixtureIdstring · uuidOptional

The unique identifier of the fixture

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc
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
nameFamilyLatinStartsWithstring · max: 50Optional

Family latin name starts with

nameFamilyLocalStartsWithstring · max: 50Optional

Family local name starts with

nameFullLatinstring · max: 50Optional

The full name of the person in latin characters

nameFullLatinContainsstring · min: 2 · max: 50Optional

Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLatin=David Johnson nameFullLatinContains=Dav will match nameFullLatinContains=John will match nameFullLatinContains=son will not match

Example: Dav and nameFullLatin='David Johnson'
nameFullLocalstring · max: 50Optional

The full name of the person

nameFullLocalContainsstring · min: 2 · max: 50Optional

Fields that allow a 'Contains' query string parameter search for words separated by a space, matching characters left to right. Example: nameFullLocal=David Johnson nameFullLocalContains=Dav will match nameFullLocalContains=John will match nameFullLocalContains=son will not match

Example: Dav and nameFullLocal='David Johnson'
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
personIdsstring · uuidOptional

The unique identifiers of the persons (comma-delimited).

Example: 009e9276-5c80-11e8-9c2d-fa7ae01bbebc,de83c6a8-3b29-11eb-bdb7-0242ac130005
seasonIdstring · uuidOptional

The unique identifier of the season

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

Comma-delimited list of one or more fields to sort by. Each field can have '-' as prefix to sort in descending order and no prefix to sort in ascending order.

Example: -dateOffenceLocal,addedPattern: ^(\-?added|\-?updated|\-?dateOffenceLocal|\-?dateHearingLocal|\-?dateSuspendedFrom|\-?dateSuspendedTo|,)*$
updatedstring · date-timeOptional

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

Example: 2018-08-16T02:11:48
Responses
get
/football/o/{organizationId}/conduct
GET /v1/football/o/{organizationId}/conduct 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": [
    {
      "conductId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entityGroup": {
        "resourceType": "entityGroups",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "bib": "34",
      "locationOther": "location",
      "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "periodId": 0,
      "section": "text",
      "fixtureClock": "PT9M53S",
      "role": "COACH",
      "dateOffenceLocal": "1978-08-24T12:12:12",
      "conductType": [
        "SWEARING"
      ],
      "conductNotes": "text",
      "dateHearingLocal": "1978-08-24",
      "hearingNotes": "text",
      "hearingStatus": "PENDING",
      "lifeSentence": true,
      "penaltyResults": [
        {
          "penaltyType": "WEEK",
          "penaltyValue": 6
        }
      ],
      "fineAmount": 1,
      "fineCurrency": "USD",
      "fineStatus": "PAID",
      "dateSuspendedTo": "1978-08-24",
      "dateSuspendedFrom": "1978-08-24",
      "dateFinePaidLocal": "1978-08-24",
      "status": "ACTIVE",
      "externalId": "A123",
      "updated": "2025-11-19T06:02:35.172Z",
      "added": "2025-11-19T06:02:35.172Z"
    }
  ]
}

Create a conduct

post
/football/o/{organizationId}/conduct

Insert a new conduct

Required scopes
This endpoint requires the following scopes:
  • : Write/Update any data from below the organization
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
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
conductIdstring · uuidOptional

The unique identifier of the conduct

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

The unique identifier of the person

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

The club that this team belongs to

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

The unique identifier of the team

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

The unique identifier of the venue

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

The unique identifier of the match

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

The unique identifier of the season

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

The unique identifier of the competition

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

The number displayed on the jersey

Example: 34
locationOtherstring | nullableOptional

The location where the incident occurred

Example: location
eventIdstring · uuidOptional

The event that this conduct is linked to

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

The identifier for the period

  • None Total match
  • 1 Period 1
  • 2 Period 2
  • 3 Period 3
  • 4 Period 4
  • 10 Extratime 1
  • 11 Extratime 2
  • 12 Extratime 3
  • 13 Extratime 4
  • 14 Extratime 5
  • 15 Extratime 6
  • 20 Penalty shoot out
Possible values:
sectionstring · max: 100Optional

The section of the period (sub-period)

fixtureClockstring | nullableOptional

Match clock when the incident occurred

Example: PT9M53S
rolestring · enum | nullableOptional

The role of person

  • None None
  • CAPTAIN Captain
  • CAPTAIN_VICE Vice Captain
  • CEO CEO
  • COACH Coach
  • COACH_ASSISTANT Assistant Coach
  • COACH_ASSISTANT_HEAD Assistant Head Coach
  • COACH_ASSOCIATE_HEAD Associate Head Coach
  • COACH_DEVELOPMENT Development Coach
  • COACH_HEAD Head Coach
  • COACH_HEAD_INTERIM Interim Head Coach
  • COACH_OTHER Other coaching staff
  • COACH_SC Strengh and Conditioning Coach
  • COACH_SENIOR Senior Coach
  • COACH_SPECIALIST Specialist Coach
  • COMMISSIONER Commissioner
  • COMMITTEE Committee
  • CREW_CHIEF Crew Chief
  • DIRECTOR Director
  • DOCTOR Doctor
  • GENERAL General
  • GROUNDSKEEPER Groundskeeper
  • JUDGE_SCORING Scoring Judge (SJ)
  • JUDGE_TIMING Timing Judge (TJ)
  • MANAGER Manager
  • MATCH_OFFICIAL Match Official
  • MEDIA_OFFICER Media Officer
  • MEDICAL_STAFF Medical Staff
  • OTHER Other
  • PHYSIOTHERAPIST Physiotherapist
  • PRESIDENT President
  • PRESIDENT_VICE Vice President
  • REFEREE Referee
  • REFEREE_ASSISTANT Referee Assistant
  • REFEREE_ASSISTANT_RESERVE Reserve Assistant Referee
  • REFEREE_RESERVE Reserve Referee
  • SCOREKEEPER Scorekeeper
  • SCOREKEEPER_ASSISTANT Assistant Scorekeeper
  • SCORER Scorer
  • SCORER_ASSISTANT Assistant Scorer
  • SECRETARY Secretary
  • STATISTICIAN Statistician
  • TECHNICAL_OFFICIAL Technical Official (TO)
  • TIMEKEEPER Timekeeper
  • TIMER Timer
  • TRAINER Trainer
  • TRAINER_ASSISTANT Assitant Trainer
  • TRANSLATOR Translator
  • TREASURER Treasurer
  • UMPIRE Umpire
  • UMPIRE_RESERVE Reserve Umpire (RU)
  • UMPIRE_VIDEO Video Umpire (VU)
  • VIDEO_TECHNICIAN Video Technician (VT)
Example: COACHPossible values:
dateOffenceLocalstring · date-time | nullableOptional

Date & Time of the Offence in the local timezone

Example: 1978-08-24T12:12:12
conductNotesstring | nullableOptional

Notes of the Conduct incident

dateHearingLocalstring · date | nullableOptional

Date hearing

Example: 1978-08-24
hearingNotesstring | nullableOptional

Notes from the conduct hearing

hearingStatusstring · enum | nullableOptional

Conduct hearing status

  • None None
  • FINALIZED Finalized
  • PENDING Pending
Example: PENDINGPossible values:
lifeSentencebooleanOptional

Was the result of the conduct hearing a life sentence?

Example: true
fineAmountnumber · floatOptional

Conduct fine amount

fineCurrencystring | nullableOptional

Fine currency

Example: USD
fineStatusstring · enum | nullableOptional

Conduct fine due status

  • None None
  • CANCELLED Cancelled
  • ISSUED Issued
  • OTHER Other
  • PAID Paid
  • UNPAID Unpaid
Example: PAIDPossible values:
dateSuspendedTostring · date | nullableOptional

Date the suspension ended

Example: 1978-08-24
dateSuspendedFromstring · date | nullableOptional

Date the suspension started

Example: 1978-08-24
dateFinePaidLocalstring · date | nullableOptional

Date the fine was paid

Example: 1978-08-24
statusstring · enum | nullableOptional

Conduct status

  • None None
  • ACTIVE Active
  • CLOSED Closed
  • COMPLETE Complete
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
post
/football/o/{organizationId}/conduct
POST /v1/football/o/{organizationId}/conduct HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1009

{
  "conductId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "bib": "34",
  "locationOther": "location",
  "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "periodId": 0,
  "section": "text",
  "fixtureClock": "PT9M53S",
  "role": "COACH",
  "dateOffenceLocal": "1978-08-24T12:12:12",
  "conductType": [
    "SWEARING"
  ],
  "conductNotes": "text",
  "dateHearingLocal": "1978-08-24",
  "hearingNotes": "text",
  "hearingStatus": "PENDING",
  "lifeSentence": true,
  "penaltyResults": [
    {
      "penaltyType": "WEEK",
      "penaltyValue": 6
    }
  ],
  "fineAmount": 1,
  "fineCurrency": "USD",
  "fineStatus": "PAID",
  "dateSuspendedTo": "1978-08-24",
  "dateSuspendedFrom": "1978-08-24",
  "dateFinePaidLocal": "1978-08-24",
  "status": "ACTIVE",
  "externalId": "A123"
}
{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "conductId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entityGroup": {
        "resourceType": "entityGroups",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "bib": "34",
      "locationOther": "location",
      "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "periodId": 0,
      "section": "text",
      "fixtureClock": "PT9M53S",
      "role": "COACH",
      "dateOffenceLocal": "1978-08-24T12:12:12",
      "conductType": [
        "SWEARING"
      ],
      "conductNotes": "text",
      "dateHearingLocal": "1978-08-24",
      "hearingNotes": "text",
      "hearingStatus": "PENDING",
      "lifeSentence": true,
      "penaltyResults": [
        {
          "penaltyType": "WEEK",
          "penaltyValue": 6
        }
      ],
      "fineAmount": 1,
      "fineCurrency": "USD",
      "fineStatus": "PAID",
      "dateSuspendedTo": "1978-08-24",
      "dateSuspendedFrom": "1978-08-24",
      "dateFinePaidLocal": "1978-08-24",
      "status": "ACTIVE",
      "externalId": "A123",
      "updated": "2025-11-19T06:02:35.172Z",
      "added": "2025-11-19T06:02:35.172Z"
    }
  ]
}

Get a conduct

get
/football/o/{organizationId}/conduct/{conductId}

Return detailed information about a specific conduct

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
conductIdstring · uuidRequired

The unique identifier of the conduct

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
get
/football/o/{organizationId}/conduct/{conductId}
GET /v1/football/o/{organizationId}/conduct/{conductId} 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": [
    {
      "conductId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entityGroup": {
        "resourceType": "entityGroups",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "bib": "34",
      "locationOther": "location",
      "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "periodId": 0,
      "section": "text",
      "fixtureClock": "PT9M53S",
      "role": "COACH",
      "dateOffenceLocal": "1978-08-24T12:12:12",
      "conductType": [
        "SWEARING"
      ],
      "conductNotes": "text",
      "dateHearingLocal": "1978-08-24",
      "hearingNotes": "text",
      "hearingStatus": "PENDING",
      "lifeSentence": true,
      "penaltyResults": [
        {
          "penaltyType": "WEEK",
          "penaltyValue": 6
        }
      ],
      "fineAmount": 1,
      "fineCurrency": "USD",
      "fineStatus": "PAID",
      "dateSuspendedTo": "1978-08-24",
      "dateSuspendedFrom": "1978-08-24",
      "dateFinePaidLocal": "1978-08-24",
      "status": "ACTIVE",
      "externalId": "A123",
      "updated": "2025-11-19T06:02:35.172Z",
      "added": "2025-11-19T06:02:35.172Z"
    }
  ]
}

Update a conduct

put
/football/o/{organizationId}/conduct/{conductId}

Change the information of a specific conduct

Required scopes
This endpoint requires the following scopes:
  • : Write/Update any data from below the organization
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
conductIdstring · uuidRequired

The unique identifier of the conduct

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
personIdstring · uuidOptional

The unique identifier of the person

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

The club that this team belongs to

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

The unique identifier of the team

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

The unique identifier of the venue

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

The unique identifier of the match

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

The unique identifier of the season

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

The unique identifier of the competition

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

The number displayed on the jersey

Example: 34
locationOtherstring | nullableOptional

The location where the incident occurred

Example: location
eventIdstring · uuidOptional

The event that this conduct is linked to

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

The identifier for the period

  • None Total match
  • 1 Period 1
  • 2 Period 2
  • 3 Period 3
  • 4 Period 4
  • 10 Extratime 1
  • 11 Extratime 2
  • 12 Extratime 3
  • 13 Extratime 4
  • 14 Extratime 5
  • 15 Extratime 6
  • 20 Penalty shoot out
Possible values:
sectionstring · max: 100Optional

The section of the period (sub-period)

fixtureClockstring | nullableOptional

Match clock when the incident occurred

Example: PT9M53S
rolestring · enum | nullableOptional

The role of person

  • None None
  • CAPTAIN Captain
  • CAPTAIN_VICE Vice Captain
  • CEO CEO
  • COACH Coach
  • COACH_ASSISTANT Assistant Coach
  • COACH_ASSISTANT_HEAD Assistant Head Coach
  • COACH_ASSOCIATE_HEAD Associate Head Coach
  • COACH_DEVELOPMENT Development Coach
  • COACH_HEAD Head Coach
  • COACH_HEAD_INTERIM Interim Head Coach
  • COACH_OTHER Other coaching staff
  • COACH_SC Strengh and Conditioning Coach
  • COACH_SENIOR Senior Coach
  • COACH_SPECIALIST Specialist Coach
  • COMMISSIONER Commissioner
  • COMMITTEE Committee
  • CREW_CHIEF Crew Chief
  • DIRECTOR Director
  • DOCTOR Doctor
  • GENERAL General
  • GROUNDSKEEPER Groundskeeper
  • JUDGE_SCORING Scoring Judge (SJ)
  • JUDGE_TIMING Timing Judge (TJ)
  • MANAGER Manager
  • MATCH_OFFICIAL Match Official
  • MEDIA_OFFICER Media Officer
  • MEDICAL_STAFF Medical Staff
  • OTHER Other
  • PHYSIOTHERAPIST Physiotherapist
  • PRESIDENT President
  • PRESIDENT_VICE Vice President
  • REFEREE Referee
  • REFEREE_ASSISTANT Referee Assistant
  • REFEREE_ASSISTANT_RESERVE Reserve Assistant Referee
  • REFEREE_RESERVE Reserve Referee
  • SCOREKEEPER Scorekeeper
  • SCOREKEEPER_ASSISTANT Assistant Scorekeeper
  • SCORER Scorer
  • SCORER_ASSISTANT Assistant Scorer
  • SECRETARY Secretary
  • STATISTICIAN Statistician
  • TECHNICAL_OFFICIAL Technical Official (TO)
  • TIMEKEEPER Timekeeper
  • TIMER Timer
  • TRAINER Trainer
  • TRAINER_ASSISTANT Assitant Trainer
  • TRANSLATOR Translator
  • TREASURER Treasurer
  • UMPIRE Umpire
  • UMPIRE_RESERVE Reserve Umpire (RU)
  • UMPIRE_VIDEO Video Umpire (VU)
  • VIDEO_TECHNICIAN Video Technician (VT)
Example: COACHPossible values:
dateOffenceLocalstring · date-time | nullableOptional

Date & Time of the Offence in the local timezone

Example: 1978-08-24T12:12:12
conductNotesstring | nullableOptional

Notes of the Conduct incident

dateHearingLocalstring · date | nullableOptional

Date hearing

Example: 1978-08-24
hearingNotesstring | nullableOptional

Notes from the conduct hearing

hearingStatusstring · enum | nullableOptional

Conduct hearing status

  • None None
  • FINALIZED Finalized
  • PENDING Pending
Example: PENDINGPossible values:
lifeSentencebooleanOptional

Was the result of the conduct hearing a life sentence?

Example: true
fineAmountnumber · floatOptional

Conduct fine amount

fineCurrencystring | nullableOptional

Fine currency

Example: USD
fineStatusstring · enum | nullableOptional

Conduct fine due status

  • None None
  • CANCELLED Cancelled
  • ISSUED Issued
  • OTHER Other
  • PAID Paid
  • UNPAID Unpaid
Example: PAIDPossible values:
dateSuspendedTostring · date | nullableOptional

Date the suspension ended

Example: 1978-08-24
dateSuspendedFromstring · date | nullableOptional

Date the suspension started

Example: 1978-08-24
dateFinePaidLocalstring · date | nullableOptional

Date the fine was paid

Example: 1978-08-24
statusstring · enum | nullableOptional

Conduct status

  • None None
  • ACTIVE Active
  • CLOSED Closed
  • COMPLETE Complete
  • INACTIVE Inactive
  • PENDING Pending
Example: ACTIVEPossible values:
externalIdstring | nullableOptional

The Id of the data as set by the provider of the data

Example: A123Pattern: ^[0-9A-Za-z/_-]+$
Responses
put
/football/o/{organizationId}/conduct/{conductId}
PUT /v1/football/o/{organizationId}/conduct/{conductId} HTTP/1.1
Host: api.dc.connect.sportradar.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 958

{
  "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "bib": "34",
  "locationOther": "location",
  "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
  "periodId": 0,
  "section": "text",
  "fixtureClock": "PT9M53S",
  "role": "COACH",
  "dateOffenceLocal": "1978-08-24T12:12:12",
  "conductType": [
    "SWEARING"
  ],
  "conductNotes": "text",
  "dateHearingLocal": "1978-08-24",
  "hearingNotes": "text",
  "hearingStatus": "PENDING",
  "lifeSentence": true,
  "penaltyResults": [
    {
      "penaltyType": "WEEK",
      "penaltyValue": 6
    }
  ],
  "fineAmount": 1,
  "fineCurrency": "USD",
  "fineStatus": "PAID",
  "dateSuspendedTo": "1978-08-24",
  "dateSuspendedFrom": "1978-08-24",
  "dateFinePaidLocal": "1978-08-24",
  "status": "ACTIVE",
  "externalId": "A123"
}
{
  "meta": {
    "version": 1,
    "codeVersion": "d6cd1e2bd19e03a81132a23b2025920577f84e37",
    "code": 200,
    "time": "2018-06-05 23:43:41.227584+00:00",
    "fromCache": false,
    "count": 7,
    "limit": 10,
    "offset": 10,
    "generationTime": 0.011604
  },
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "previous": "https://example.com"
  },
  "included": {
    "resources": {
      "ANY_ADDITIONAL_PROPERTY": "league"
    }
  },
  "data": [
    {
      "conductId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entityGroup": {
        "resourceType": "entityGroups",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "bib": "34",
      "locationOther": "location",
      "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "periodId": 0,
      "section": "text",
      "fixtureClock": "PT9M53S",
      "role": "COACH",
      "dateOffenceLocal": "1978-08-24T12:12:12",
      "conductType": [
        "SWEARING"
      ],
      "conductNotes": "text",
      "dateHearingLocal": "1978-08-24",
      "hearingNotes": "text",
      "hearingStatus": "PENDING",
      "lifeSentence": true,
      "penaltyResults": [
        {
          "penaltyType": "WEEK",
          "penaltyValue": 6
        }
      ],
      "fineAmount": 1,
      "fineCurrency": "USD",
      "fineStatus": "PAID",
      "dateSuspendedTo": "1978-08-24",
      "dateSuspendedFrom": "1978-08-24",
      "dateFinePaidLocal": "1978-08-24",
      "status": "ACTIVE",
      "externalId": "A123",
      "updated": "2025-11-19T06:02:35.172Z",
      "added": "2025-11-19T06:02:35.172Z"
    }
  ]
}

Delete a conduct

delete
/football/o/{organizationId}/conduct/{conductId}

Delete a specific conduct

Required scopes
This endpoint requires the following scopes:
  • : Write/Update any data from below the organization
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
conductIdstring · uuidRequired

The unique identifier of the conduct

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
delete
/football/o/{organizationId}/conduct/{conductId}
DELETE /v1/football/o/{organizationId}/conduct/{conductId} 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": [
    {
      "conductId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "organizationId": "9",
      "organization": {
        "resourceType": "organizations",
        "id": "9"
      },
      "personId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "person": {
        "resourceType": "persons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityGroupId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entityGroup": {
        "resourceType": "entityGroups",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "entityId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "entity": {
        "resourceType": "entities",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "venueId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "venue": {
        "resourceType": "venues",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "fixtureId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "fixture": {
        "resourceType": "fixtures",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "seasonId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "season": {
        "resourceType": "seasons",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "competitionId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "competition": {
        "resourceType": "competitions",
        "id": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc"
      },
      "bib": "34",
      "locationOther": "location",
      "eventId": "009e9276-5c80-11e8-9c2d-fa7ae01bbebc",
      "periodId": 0,
      "section": "text",
      "fixtureClock": "PT9M53S",
      "role": "COACH",
      "dateOffenceLocal": "1978-08-24T12:12:12",
      "conductType": [
        "SWEARING"
      ],
      "conductNotes": "text",
      "dateHearingLocal": "1978-08-24",
      "hearingNotes": "text",
      "hearingStatus": "PENDING",
      "lifeSentence": true,
      "penaltyResults": [
        {
          "penaltyType": "WEEK",
          "penaltyValue": 6
        }
      ],
      "fineAmount": 1,
      "fineCurrency": "USD",
      "fineStatus": "PAID",
      "dateSuspendedTo": "1978-08-24",
      "dateSuspendedFrom": "1978-08-24",
      "dateFinePaidLocal": "1978-08-24",
      "status": "ACTIVE",
      "externalId": "A123",
      "updated": "2025-11-19T06:02:35.172Z",
      "added": "2025-11-19T06:02:35.172Z"
    }
  ]
}
PreviousSeason Person PlacingsNextPerson External IDs

Last updated

Was this helpful?