# Person Match Statistics Persons can have statistics associated with their participation in a match. There are two types of statistics collected: * Total * By Period The *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently. ## Person total statistics > Return a list of person total statistics for a match. Statistics are the totals (all periods added together) for the match. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_StatisticsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":30,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- None (Blank)\n>- `AM` Attacking Midfield\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LF` Left Forward\n>- `M` Midfielder\n>- `O` Outfielder\n>- `RF` Right Forward\n>- `S` Striker\n>- `SW` Sweeper\n","type":"string","enum":["GK","O","D","FB","HB","SW","M","CH","DM","AM","F","CF","LF","RF","S","",null],"maxLength":30,"nullable":true},"didNotPlayReason":{"description":"The reason the player didn't play","type":"string","maxLength":100,"nullable":true},"starter":{"description":"","type":"boolean"},"participated":{"description":"Did the person actually participate in the the match","type":"boolean"},"isPlayer":{"description":"Is this person a player","type":"boolean"},"isTeamOfficial":{"description":"Is this person a team official","type":"boolean"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"multipleEntityIds":{"name":"entityId","description":"The unique identifiers of the teams (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"isPlayer":{"name":"isPlayer","description":"Is the person a player?","schema":{"type":"boolean"},"required":false,"in":"query"},"isTeamOfficial":{"name":"isTeamOfficial","description":"Is the person a team official?","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"participated":{"name":"participated","description":"Only show persons who participated.","schema":{"type":"boolean"},"required":false,"in":"query"},"multiplePersonIds":{"name":"personId","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"starter":{"name":"starter","description":"Is the person a starter in the match ?","schema":{"type":"boolean"},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/{fixtureId}":{"get":{"tags":["Person Match Statistics"],"summary":"Person total statistics","description":"Return a list of person total statistics for a match. Statistics are the totals (all periods added together) for the match.","operationId":"fps_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_StatisticsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/multipleEntityIds"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/isPlayer"},{"$ref":"#/components/parameters/isTeamOfficial"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/participated"},{"$ref":"#/components/parameters/multiplePersonIds"},{"$ref":"#/components/parameters/starter"},{"$ref":"#/components/parameters/updated"}]}}}} ``` ## Delete person total statistics > Delete a total statistic record for a person in a match. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_StatisticsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":30,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- None (Blank)\n>- `AM` Attacking Midfield\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LF` Left Forward\n>- `M` Midfielder\n>- `O` Outfielder\n>- `RF` Right Forward\n>- `S` Striker\n>- `SW` Sweeper\n","type":"string","enum":["GK","O","D","FB","HB","SW","M","CH","DM","AM","F","CF","LF","RF","S","",null],"maxLength":30,"nullable":true},"didNotPlayReason":{"description":"The reason the player didn't play","type":"string","maxLength":100,"nullable":true},"starter":{"description":"","type":"boolean"},"participated":{"description":"Did the person actually participate in the the match","type":"boolean"},"isPlayer":{"description":"Is this person a player","type":"boolean"},"isTeamOfficial":{"description":"Is this person a team official","type":"boolean"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"forceDelete":{"name":"forceDelete","description":"Force a delete command to run and delete child records as well if there are existing records depending on the record.","schema":{"type":"boolean"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/{fixtureId}":{"delete":{"tags":["Person Match Statistics"],"summary":"Delete person total statistics","description":"Delete a total statistic record for a person in a match.","operationId":"fps_delete_all","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_StatisticsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/personId"}]}}}} ``` ## Person total statistics for matches in a season > Return a list of person total statistics for matches in a season. Statistics are the totals (all periods added together) for the match. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_StatisticsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":30,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- None (Blank)\n>- `AM` Attacking Midfield\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LF` Left Forward\n>- `M` Midfielder\n>- `O` Outfielder\n>- `RF` Right Forward\n>- `S` Striker\n>- `SW` Sweeper\n","type":"string","enum":["GK","O","D","FB","HB","SW","M","CH","DM","AM","F","CF","LF","RF","S","",null],"maxLength":30,"nullable":true},"didNotPlayReason":{"description":"The reason the player didn't play","type":"string","maxLength":100,"nullable":true},"starter":{"description":"","type":"boolean"},"participated":{"description":"Did the person actually participate in the the match","type":"boolean"},"isPlayer":{"description":"Is this person a player","type":"boolean"},"isTeamOfficial":{"description":"Is this person a team official","type":"boolean"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"multipleEntityIds":{"name":"entityId","description":"The unique identifiers of the teams (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"isPlayer":{"name":"isPlayer","description":"Is the person a player?","schema":{"type":"boolean"},"required":false,"in":"query"},"isTeamOfficial":{"name":"isTeamOfficial","description":"Is the person a team official?","schema":{"type":"boolean"},"required":false,"in":"query"},"statlimit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":300,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"participated":{"name":"participated","description":"Only show persons who participated.","schema":{"type":"boolean"},"required":false,"in":"query"},"multiplePersonIds":{"name":"personId","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"starter":{"name":"starter","description":"Is the person a starter in the match ?","schema":{"type":"boolean"},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/seasons/{seasonId}/statistics/for/person/in/fixtures":{"get":{"tags":["Person Match Statistics"],"summary":"Person total statistics for matches in a season","description":"Return a list of person total statistics for matches in a season. Statistics are the totals (all periods added together) for the match.","operationId":"fps_list_by_season","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_StatisticsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/multipleEntityIds"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/isPlayer"},{"$ref":"#/components/parameters/isTeamOfficial"},{"$ref":"#/components/parameters/statlimit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/participated"},{"$ref":"#/components/parameters/multiplePersonIds"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/starter"},{"$ref":"#/components/parameters/updated"}]}}}} ``` ## Person total statistics - live > \ > Return a list of live person total statistics for a match. Statistics are the totals\ > (all periods added together) for the match. This call will return records of matches still in-progress\ > if available. If the match is complete this call operates the same as the non 'live' route.\ > \ > Rate limited to 2 requests every minute - returns HTTP 429 Too Many Requests if called more often.\ > ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization_live"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_StatisticsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":30,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- None (Blank)\n>- `AM` Attacking Midfield\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LF` Left Forward\n>- `M` Midfielder\n>- `O` Outfielder\n>- `RF` Right Forward\n>- `S` Striker\n>- `SW` Sweeper\n","type":"string","enum":["GK","O","D","FB","HB","SW","M","CH","DM","AM","F","CF","LF","RF","S","",null],"maxLength":30,"nullable":true},"didNotPlayReason":{"description":"The reason the player didn't play","type":"string","maxLength":100,"nullable":true},"starter":{"description":"","type":"boolean"},"participated":{"description":"Did the person actually participate in the the match","type":"boolean"},"isPlayer":{"description":"Is this person a player","type":"boolean"},"isTeamOfficial":{"description":"Is this person a team official","type":"boolean"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"multipleEntityIds":{"name":"entityId","description":"The unique identifiers of the teams (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"isPlayer":{"name":"isPlayer","description":"Is the person a player?","schema":{"type":"boolean"},"required":false,"in":"query"},"isTeamOfficial":{"name":"isTeamOfficial","description":"Is the person a team official?","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"participated":{"name":"participated","description":"Only show persons who participated.","schema":{"type":"boolean"},"required":false,"in":"query"},"multiplePersonIds":{"name":"personId","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"starter":{"name":"starter","description":"Is the person a starter in the match ?","schema":{"type":"boolean"},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/{fixtureId}/live":{"get":{"tags":["Person Match Statistics"],"summary":"Person total statistics - live","description":"\n Return a list of live person total statistics for a match. Statistics are the totals\n (all periods added together) for the match. This call will return records of matches still in-progress\n if available. If the match is complete this call operates the same as the non 'live' route.\n\n Rate limited to 2 requests every minute - returns HTTP 429 Too Many Requests if called more often.\n ","operationId":"fps_listlive","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_StatisticsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/multipleEntityIds"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/isPlayer"},{"$ref":"#/components/parameters/isTeamOfficial"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/participated"},{"$ref":"#/components/parameters/multiplePersonIds"},{"$ref":"#/components/parameters/starter"},{"$ref":"#/components/parameters/updated"}]}}}} ``` ## Create/Update person total statistics > Depending on the data, add or update a total statistic record for a person in a match. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_StatisticsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":30,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- None (Blank)\n>- `AM` Attacking Midfield\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LF` Left Forward\n>- `M` Midfielder\n>- `O` Outfielder\n>- `RF` Right Forward\n>- `S` Striker\n>- `SW` Sweeper\n","type":"string","enum":["GK","O","D","FB","HB","SW","M","CH","DM","AM","F","CF","LF","RF","S","",null],"maxLength":30,"nullable":true},"didNotPlayReason":{"description":"The reason the player didn't play","type":"string","maxLength":100,"nullable":true},"starter":{"description":"","type":"boolean"},"participated":{"description":"Did the person actually participate in the the match","type":"boolean"},"isPlayer":{"description":"Is this person a player","type":"boolean"},"isTeamOfficial":{"description":"Is this person a team official","type":"boolean"},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures":{"post":{"tags":["Person Match Statistics"],"summary":"Create/Update person total statistics","description":"Depending on the data, add or update a total statistic record for a person in a match.","operationId":"fps_insert_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_StatisticsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":30,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- None (Blank)\n>- `AM` Attacking Midfield\n>- `CF` Centre Forward\n>- `CH` Centre Half\n>- `D` Defender\n>- `DM` Defensive Midfield\n>- `F` Forward\n>- `FB` Full Back\n>- `GK` Goal Keeper\n>- `HB` Half Back\n>- `LF` Left Forward\n>- `M` Midfielder\n>- `O` Outfielder\n>- `RF` Right Forward\n>- `S` Striker\n>- `SW` Sweeper\n","type":"string","enum":["GK","O","D","FB","HB","SW","M","CH","DM","AM","F","CF","LF","RF","S","",null],"maxLength":30,"nullable":true},"didNotPlayReason":{"description":"The reason the player didn't play","type":"string","maxLength":100,"nullable":true},"starter":{"description":"","type":"boolean"},"participated":{"description":"Did the person actually participate in the the match","type":"boolean"},"isPlayer":{"description":"Is this person a player","type":"boolean"},"isTeamOfficial":{"description":"Is this person a team official","type":"boolean"}},"title":"match person statistics post body","required":["personId","fixtureId"]}}}}}}}} ``` ## Person period statistics > Return a list of person period statistics for a match ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_Statistics_PeriodsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics periods belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics periods model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"multipleEntityIds":{"name":"entityId","description":"The unique identifiers of the teams (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"periodId":{"name":"periodId","description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","schema":{"type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"required":false,"in":"query"},"multiplePersonIds":{"name":"personId","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"section":{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/{fixtureId}/periods":{"get":{"tags":["Person Match Statistics"],"summary":"Person period statistics","description":"Return a list of person period statistics for a match","operationId":"fpsp_listperiod","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics_Periods Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_Statistics_PeriodsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/multipleEntityIds"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/periodId"},{"$ref":"#/components/parameters/multiplePersonIds"},{"$ref":"#/components/parameters/section"},{"$ref":"#/components/parameters/updated"}]}}}} ``` ## Delete person period statistics > Delete a period statistic record for a person in a match. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_Statistics_PeriodsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics periods belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics periods model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"entityId":{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"forceDelete":{"name":"forceDelete","description":"Force a delete command to run and delete child records as well if there are existing records depending on the record.","schema":{"type":"boolean"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"periodId":{"name":"periodId","description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","schema":{"type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"required":false,"in":"query"},"personId":{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"section":{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/{fixtureId}/periods":{"delete":{"tags":["Person Match Statistics"],"summary":"Delete person period statistics","description":"Delete a period statistic record for a person in a match.","operationId":"fpsp_delete_all","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics_Periods Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_Statistics_PeriodsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/forceDelete"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/periodId"},{"$ref":"#/components/parameters/personId"},{"$ref":"#/components/parameters/section"}]}}}} ``` ## Person period statistics for matches in a season > Return a list of person period statistics for matches in a season. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_Statistics_PeriodsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics periods belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics periods model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"multipleEntityIds":{"name":"entityId","description":"The unique identifiers of the teams (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"isPlayer":{"name":"isPlayer","description":"Is the person a player?","schema":{"type":"boolean"},"required":false,"in":"query"},"isTeamOfficial":{"name":"isTeamOfficial","description":"Is the person a team official?","schema":{"type":"boolean"},"required":false,"in":"query"},"statlimit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":300,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"participated":{"name":"participated","description":"Only show persons who participated.","schema":{"type":"boolean"},"required":false,"in":"query"},"multiplePersonIds":{"name":"personId","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"starter":{"name":"starter","description":"Is the person a starter in the match ?","schema":{"type":"boolean"},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/seasons/{seasonId}/statistics/for/person/in/fixtures/periods":{"get":{"tags":["Person Match Statistics"],"summary":"Person period statistics for matches in a season","description":"Return a list of person period statistics for matches in a season.","operationId":"fpsp_list_by_season","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics_Periods Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_Statistics_PeriodsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/multipleEntityIds"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/isPlayer"},{"$ref":"#/components/parameters/isTeamOfficial"},{"$ref":"#/components/parameters/statlimit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/participated"},{"$ref":"#/components/parameters/multiplePersonIds"},{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/starter"},{"$ref":"#/components/parameters/updated"}]}}}} ``` ## Person period statistics - live > Return a list of person period statistics for a match ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["read:organization_live"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_Statistics_PeriodsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics periods belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics periods model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"added":{"name":"added","description":"Record was added after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"},"multipleEntityIds":{"name":"entityId","description":"The unique identifiers of the teams (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"limit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":1000,"minimum":1,"default":10},"required":false,"in":"query"},"offset":{"name":"offset","description":"The offset of the records. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32"},"required":false,"in":"query"},"periodId":{"name":"periodId","description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","schema":{"type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"required":false,"in":"query"},"multiplePersonIds":{"name":"personId","description":"The unique identifiers of the persons (comma-delimited).","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"section":{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"},"updated":{"name":"updated","description":"Record was modified after this date/time. In UTC.","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/{fixtureId}/periods/live":{"get":{"tags":["Person Match Statistics"],"summary":"Person period statistics - live","description":"Return a list of person period statistics for a match","operationId":"fpsp_listperiodlive","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics_Periods Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_Statistics_PeriodsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/multipleEntityIds"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"$ref":"#/components/parameters/periodId"},{"$ref":"#/components/parameters/multiplePersonIds"},{"$ref":"#/components/parameters/section"},{"$ref":"#/components/parameters/updated"}]}}}} ``` ## Create/Update person period statistics > Depending on the data, add or update a period statistic record for a person in a match. ```json {"openapi":"3.0.0","info":{"title":"DataCore API - Hockey","version":"v1"},"tags":[{"name":"Person Match Statistics","description":"Persons can have statistics associated with their participation in a match.\nThere are two types of statistics collected:\n - Total\n - By Period\n\nThe *period* statistics are the statistics for just that one period, whereas the *total* statistics contain an aggregated view of all periods. Each type is separate (the 'total' is NOT created automatically by summing the period statistics) and as such needs to be added/updated/deleted independently.\n\n\n[Match Statistics{bg:orange}],[Match Statistics]-<>[Persons]\">\n"}],"servers":[{"url":"https://api.dc.connect.sportradar.com/v1","description":"Production server"},{"url":"https://api.dc.stg.connect-nonprod.sportradar.dev/v1","description":"NonProduction/Staging server"}],"security":[{"OAuth2":["write:organization"]}],"components":{"securitySchemes":{"OAuth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"orgId":"Authenticate based on a specific OrganizationId","read:orggroup":"Read data over multiple organizations using and *orggroup* code","write:organization":"Write/Update any data from below the organization","read:organization":"Read any data from the organization down","write:admin":"Perform administration API calls","write:admin_organization":"Ability to manage organizations","write:system":"Perform system configuration API calls"}}},"description":"You can create a JSON Web Token (JWT) using the [token](http://developer.connect.sportradar.com/token/#operation/getToken) 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."}},"schemas":{"ResponseMetaData":{"type":"object","properties":{"version":{"type":"integer","description":"The version of the API in use for this call"},"codeVersion":{"type":"string","description":"A string indicating the version of the code that handled this request"},"code":{"type":"integer","description":"The HTTP response code for this request"},"time":{"type":"string","format":"date-time","description":"The date/time this request was made (in UTC)."},"fromCache":{"type":"boolean","description":"Was this request served directly from the cache?"},"count":{"type":"integer","description":"The number of records being returned"},"limit":{"type":"integer","description":"The record limit in place for this request"},"offset":{"type":"integer","description":"The record offset in place for this request"},"generationTime":{"type":"number","format":"float","description":"The number of seconds taken to generate this request."}}},"ResponseLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri","description":"The URI referencing this request."},"next":{"type":"string","format":"uri","description":"The URI referencing the 'next' page, if more data is available."},"previous":{"type":"string","format":"uri","description":"The URI referencing the 'previous' page, if the request is not on the first page."}}},"IncludedData":{"type":"object","description":"Available if the request used the 'include' parameter. It contains extra data about resources found in the data block.","properties":{"resources":{"type":"object","additionalProperties":{"description":"The type of resource","type":"object","enum":["league","organisation","persons"],"additionalProperties":{"type":"object","format":"uuid","description":"The id of the resource","additionalProperties":{"description":"The model for the resource as defined by the type and id"}}}}}},"Fixture_Person_Statistics_PeriodsModel":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"person":{"properties":{"resourceType":{"type":"string","enum":["persons"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The person information","type":"object"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"fixture":{"properties":{"resourceType":{"type":"string","enum":["fixtures"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The match","type":"object"},"organizationId":{"description":"The unique identifier of the organization","type":"string","readOnly":true},"organization":{"properties":{"resourceType":{"type":"string","enum":["organizations"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The organization that this match person statistics periods belongs to","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100},"updated":{"description":"Date/time last modified. In UTC","type":"string","format":"date-time","readOnly":true},"added":{"description":"Date/time added. In UTC","type":"string","format":"date-time","readOnly":true}},"title":"match person statistics periods model"},"ErrorModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error. If there are multiple errors, then this will be the code of the first one.","format":"int32"},"message":{"type":"string","description":"A message indicating the reason for the error. If there are multiple errors, then this is the message for the first one."},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ErrorListModel"}}}},"ErrorListModel":{"type":"object","properties":{"code":{"type":"integer","description":"HTTP Error code indicating the type of error.","format":"int32"},"reason":{"enum":["INVALID_DATA","NOT_FOUND","NOT_AUTHORISED","ERROR","DELETE_ERROR"],"description":"A short code indicating the type of error"},"message":{"type":"string","description":"A message indicating the reason for the error"},"rowNumber":{"type":"integer","description":"The row number of the payload that cause the error","format":"int32"}}}},"responses":{"ErrorResponse":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"error":{"$ref":"#/components/schemas/ErrorModel"}}}}}}},"parameters":{"external":{"name":"external","description":"A comma separated list of fields that will instead be interpreted as an externalId. See [External Ids](#section/Introduction/External-Ids) for more information.","schema":{"type":"string"},"required":false,"in":"query"},"fields":{"name":"fields","description":"A comma separated list of fields to display. The response will only display these fields. See [Partial Response](#section/Partial-Response) section for more information.","schema":{"type":"string"},"required":false,"in":"query"},"hideNull":{"name":"hideNull","description":"Don't display data fields with null values or empty structures","schema":{"type":"boolean"},"required":false,"in":"query"},"include":{"name":"include","description":"A comma separated list of resource types to include. See [Resource Inclusion](#section/Introduction/Resource-Inclusion) for more information.","schema":{"type":"string"},"required":false,"in":"query"}}},"paths":{"/hockey/o/{organizationId}/statistics/for/person/in/fixtures/periods":{"post":{"tags":["Person Match Statistics"],"summary":"Create/Update person period statistics","description":"Depending on the data, add or update a period statistic record for a person in a match.","operationId":"fpsp_insert_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Person_Statistics_Periods Response","properties":{"meta":{"$ref":"#/components/schemas/ResponseMetaData"},"links":{"$ref":"#/components/schemas/ResponseLinks"},"included":{"$ref":"#/components/schemas/IncludedData"},"data":{"type":"array","description":"","items":{"$ref":"#/components/schemas/Fixture_Person_Statistics_PeriodsModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid","nullable":true},"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"badPasses":{"description":"Number of unsuccessful passes completed","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"challengesEarned":{"description":"Total number of challenges earned","type":"integer","nullable":true,"format":"int32"},"challengesScored":{"description":"Total number of goals scored from a challenge","type":"integer","nullable":true,"format":"int32"},"circlePenetrations":{"description":"Total number of circle entries","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsMissed":{"description":"Total number of field goal conversions missed","type":"integer","nullable":true,"format":"int32"},"fieldGoalConversionsScored":{"description":"Total number of goals scored from Field Goal Conversions","type":"integer","nullable":true,"format":"int32"},"fieldGoalsScored":{"description":"Total number of Field Goals scored","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsConcededShootOut":{"description":"Total number of goals conceded during shoot-outs","type":"integer","nullable":true,"format":"int32"},"goalsScored":{"description":"Total number of goals scored","type":"integer","nullable":true,"format":"int32"},"goalsShootOut":{"description":"Total number of goals scored from shoot out shots","type":"integer","nullable":true,"format":"int32"},"greenCards":{"description":"Total number of green cards","type":"integer","nullable":true,"format":"int32"},"interceptions":{"description":"Total number of interceptions","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the field. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"minus":{"description":"The number of goals conceded by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"passAccuracy":{"description":"The percentage of successful passes","type":"number","nullable":true,"format":"float"},"passes":{"description":"Number of successful passes completed","type":"integer","nullable":true,"format":"int32"},"penaltyCornersEarned":{"description":"Total number of penalty corners earned","type":"integer","nullable":true,"format":"int32"},"penaltyCornersScored":{"description":"Total number of goals scored from Penalty Corners","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesEarned":{"description":"Total number of penalty strokes earned","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesMissed":{"description":"Total number of penalty strokes missed","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesSaved":{"description":"Total number of penalty strokes saved","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesScored":{"description":"Total number of goals scored from Penalty Strokes","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutEarned":{"description":"Total number of penalty strokes earned during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutMissed":{"description":"Total number of penalty strokes missed during shootouts","type":"integer","nullable":true,"format":"int32"},"penaltyStrokesShootoutScored":{"description":"Total number of penalty strokes scored during shootouts","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesAgainst":{"description":"Total number of penalty stroke attempts faced by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesGoalsAgainst":{"description":"Total number of penalty stroke goals conceded by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaved":{"description":"Total number of penalty strokes saved by the goalkeeper","type":"integer","nullable":true,"format":"int32"},"goalKeeperPenaltyStrokesSaveAccuracy":{"description":"Rate of penalty strokes saved by the goalkeeper","type":"number","format":"float"},"plus":{"description":"The number of goals scored by the team while this player is on the field","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the field","type":"integer","nullable":true,"format":"int32"},"redCards":{"description":"Total number of red cards","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves","type":"integer","nullable":true,"format":"int32"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shotAccuracy":{"description":"The percentage of shots that are on target including goals","type":"number","nullable":true,"format":"float"},"shots":{"description":"Total number of shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots missed","type":"integer","nullable":true,"format":"int32"},"shotsMissedShootOut":{"description":"Total number of shoot out shots missed","type":"integer","nullable":true,"format":"int32"},"shotsOnTarget":{"description":"Total number of shots on target","type":"integer","nullable":true,"format":"int32"},"tackles":{"description":"Total number of successful tackles","type":"integer","nullable":true,"format":"int32"},"yellowCards":{"description":"Total number of yellow cards","type":"integer","nullable":true,"format":"int32"}}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\n>- `10` Extra time 1\n>- `11` Extra time 2\n>- `12` Shoot Out\n>- `13` Extra time 4\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11,12,13]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100}},"title":"match person statistics periods post body","required":["personId","fixtureId","periodId"]}}}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/datacore/sports-apis/field-hockey/datacore-api-v1/person-match-statistics.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.