# Person Match History

Match History for a person in a season.

## Match History for a person

> Return the Match History (based on statistics present) for a specific person in a season.

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3Ice","version":"v1"},"tags":[{"name":"Person Match History","description":"\nMatch History for a person in a season.\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"}}}}}},"Game_Log_PersonModel":{"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"},"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 game_log_person belongs to","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"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"entity":{"properties":{"resourceType":{"type":"string","enum":["entities"]},"id":{"description":"Unique identifier for this resource","type":"string"}},"description":"The team information","type":"object"},"statistics":{"type":"object","additionalProperties":false,"properties":{"assistsPrimary":{"description":"Total number of Assist 1","type":"integer","nullable":true,"format":"int32"},"assistsSecondary":{"description":"Total number of Assist 2","type":"integer","nullable":true,"format":"int32"},"assists":{"description":"Total number of assists","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"Total number of blocks","type":"integer","nullable":true,"format":"int32"},"faceOffsWon":{"description":"Total number face-off wins","type":"integer","nullable":true,"format":"int32"},"faceOffsLost":{"description":"Total number face-off loses","type":"integer","nullable":true,"format":"int32"},"goalsConceded":{"description":"Total number of goals conceded","type":"integer","nullable":true,"format":"int32"},"goalsEmptyNet":{"description":"Total number of empty net goals","type":"integer","nullable":true,"format":"int32"},"goalsPercentage":{"description":"percentage of a shots on target that go in the net","type":"number","nullable":true,"format":"float"},"goalsPenaltyShot":{"description":"Total number of goals scored from Penalty Shots","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"},"minus":{"description":"The number of goals conceded by the team while this player is on the Ice","type":"integer","nullable":true,"format":"int32"},"penalties":{"description":"Total number of penalties committed","type":"integer","nullable":true,"format":"int32"},"penaltiesDrawn":{"description":"Total number of penalties drawn","type":"integer","nullable":true,"format":"int32"},"plus":{"description":"The number of goals scored by the team while this player is on the Ice","type":"integer","nullable":true,"format":"int32"},"plusMinus":{"description":"goals scored/conceded while this player is on the Ice","type":"integer","nullable":true,"format":"int32"},"points":{"description":"Total number of points","type":"integer","nullable":true,"format":"int32"},"saves":{"description":"Total number of saves, excluding shoot out saves but including penalty shot save","type":"integer","nullable":true,"format":"int32"},"savesPenaltyShot":{"description":"Total number of penalty shots saved","type":"integer","nullable":true,"format":"int32"},"savesPercentage":{"description":"","type":"number","nullable":true,"format":"float"},"savesPercentageShootOut":{"description":"","type":"number","nullable":true,"format":"float"},"savesShootOut":{"description":"Total number of shoot out shots saved","type":"integer","nullable":true,"format":"int32"},"shots":{"description":"Total number of shots,  excludes shoot out shots","type":"integer","nullable":true,"format":"int32"},"shotsMissed":{"description":"Total number of shots off target (misses the goal and goalkeeper doesn't make a save), excludes shoot out shots","type":"integer","nullable":true,"format":"int32"},"shotsMissedPenaltyShot":{"description":"Total number of penalty 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, inclusive of penalty shots and regular shots","type":"integer","nullable":true,"format":"int32"},"shotsOnTargetAgainst":{"description":"Total number of shots faced by the goalie","type":"integer","nullable":true,"format":"int32"},"shutOut":{"description":"When the Goalkeeper does not concede a goal for the whole match","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the player was on the ice . eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true}}},"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` Shoot Out\n","type":"integer","format":"int32","enum":[0,1,2,3,4,10,11]},"section":{"description":"The section of the period (sub-period)","type":"string","maxLength":100},"bib":{"description":"The number displayed on the jersey","type":"string","maxLength":100,"nullable":true},"position":{"description":"Playing position\n>- None None\n>- `G` Goalie\n>- `S` Skater\n","type":"string","enum":["G","S",null],"maxLength":10,"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":"game_log_person 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"},"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"},"fixtureType":{"name":"fixtureType","description":"Type of match\n>- `ALL_STAR` All Star\n>- `DEMONSTRATION` Demonstration\n>- `FINAL` Final\n>- `FRIENDLY` Friendly\n>- `PLAYOFF` Playoff\n>- `PRESEASON` Pre Season\n>- `REGULAR` Regular\n","schema":{"type":"string","enum":["ALL_STAR","PRESEASON","REGULAR","FINAL","PLAYOFF","FRIENDLY","DEMONSTRATION"],"maxLength":50},"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"},"homeAway":{"name":"homeAway","description":"Where the result was\n>- `AWAY` Away\n>- `HOME` Home\n","schema":{"type":"string","enum":["HOME","AWAY"],"maxLength":50},"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"},"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"},"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"},"winLoss":{"name":"winLoss","description":"What the result was\n>- `DRAW` Draw\n>- `LOSS` Loss\n>- `WIN` Win\n","schema":{"type":"string","enum":["WIN","LOSS","DRAW"],"maxLength":50},"required":false,"in":"query"}}},"paths":{"/ice3/o/{organizationId}/statistics/for/person/{personId}/in/fixtures/seasons/{seasonId}/history":{"get":{"tags":["Person Match History"],"summary":"Match History for a person","description":"Return the Match History (based on statistics present) for a specific person in a season.","operationId":"gamelog_listperson","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Game_Log_Person 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/Game_Log_PersonModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"$ref":"#/components/parameters/entityId"},{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fixtureType"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/homeAway"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"name":"isPlayer","description":"Is the person a player?","schema":{"type":"boolean","default":true},"required":false,"in":"query"},{"$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"},{"name":"personId","description":"The unique identifier of the person","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"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"},{"$ref":"#/components/parameters/winLoss"}]}}}}
```


---

# 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/3ice/datacore-api-v1/person-match-history.md?ask=<question>
```

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.