# 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  - Ice Hockey","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":{}},"periodId":{"description":"The identifier for the period\n>- None Total match\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `11` Overtime 1\n>- `12` Overtime 2\n>- `13` Overtime 3\n>- `14` Overtime 4\n>- `15` Overtime 5\n>- `16` Overtime 6\n>- `17` Overtime 7\n>- `18` Overtime 8\n>- `19` Overtime 9\n>- `20` Overtime 10\n>- `21` Overtime 11\n>- `22` Overtime 12\n>- `23` Overtime 13\n>- `24` Overtime 14\n>- `25` Overtime 15\n>- `26` Overtime 16\n>- `27` Overtime 17\n>- `28` Overtime 18\n>- `29` Overtime 19\n>- `30` Overtime 20\n","type":"integer","format":"int32","enum":[0,1,2,3,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30]},"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","type":"string","maxLength":100,"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 entity","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 Fixture\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"},"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":{"/icehockey/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"},{"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"}]}}}}
```
