# Team Match History

Match History for a team in a season.

## Match History for a team

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

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - basketball","version":"v1"},"tags":[{"name":"Team Match History","description":"\nMatch History for a team 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_EntityModel":{"type":"object","additionalProperties":false,"properties":{"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_entity 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":{"assists":{"description":"The number of assists","type":"integer","nullable":true,"format":"int32"},"assistsAgainst":{"description":"The number of assists by the opposing team","type":"integer","nullable":true,"format":"int32"},"assistsDefensive":{"description":"The number of defensive assists","type":"integer","nullable":true,"format":"int32"},"assistsTurnoverRatio":{"description":"The ratio of assists to turnovers","type":"number","format":"float"},"biggestLead":{"description":"The largest lead","type":"integer","nullable":true,"format":"int32"},"biggestScoringRun":{"description":"The longest scoring run","type":"integer","nullable":true,"format":"int32"},"blocks":{"description":"The number of blocks made","type":"integer","nullable":true,"format":"int32"},"blocksReceived":{"description":"The number of times entity has been blocked","type":"integer","nullable":true,"format":"int32"},"dunks":{"description":"The number of dunks made","type":"integer","nullable":true,"format":"int32"},"efficiencyCustom":{"description":"Custom Efficiency rating","type":"number","nullable":true,"format":"float"},"efficiency":{"description":"Efficiency rating","type":"number","format":"float"},"pir":{"description":"Performance Index Rating","type":"number","format":"float"},"fieldGoalsAttempted":{"description":"The number of field goals (2pt + 3pt) attempted","type":"integer","nullable":true,"format":"int32"},"fieldGoalsAttemptedAgainst":{"description":"The number of field goals (2pt + 3pt) attempted by the opposing team","type":"integer","nullable":true,"format":"int32"},"fieldGoalsMade":{"description":"The number of field goals (2pt + 3pt) made","type":"integer","nullable":true,"format":"int32"},"fieldGoalsMadeAgainst":{"description":"The number of field goals (2pt + 3pt) made by the opposing team","type":"integer","nullable":true,"format":"int32"},"fieldGoalsEffectivePercentage":{"description":"The effective percentage of successful field goals","type":"number","format":"float"},"fieldGoalsPercentage":{"description":"The percentage of successful field goals","type":"number","format":"float"},"fieldGoalsPercentageAgainst":{"description":"The percentage of successful field goals made by the opposing team","type":"number","format":"float"},"freeThrowsAttempted":{"description":"The number of free throws attempted","type":"integer","nullable":true,"format":"int32"},"freeThrowsAttemptedAgainst":{"description":"The number of free throws attempted by the opposing team","type":"integer","nullable":true,"format":"int32"},"freeThrowsMade":{"description":"The number of free throws made","type":"integer","nullable":true,"format":"int32"},"freeThrowsMadeAgainst":{"description":"The number of free throws made by the opposing team","type":"integer","nullable":true,"format":"int32"},"freeThrowsPercentage":{"description":"The percentage of successful free throws","type":"number","format":"float"},"freeThrowsPercentageAgainst":{"description":"The percentage of successful free throws","type":"number","format":"float"},"foulsBenchTechnical":{"description":"The number of technical fouls on the bench","type":"integer","nullable":true,"format":"int32"},"foulsCoachDisqualifying":{"description":"The number of disqualifying fouls on the coach","type":"integer","nullable":true,"format":"int32"},"foulsCoachTechnical":{"description":"The number of technical fouls on the coach","type":"integer","nullable":true,"format":"int32"},"foulsDisqualifying":{"description":"The number of disqualifying fouls","type":"integer","nullable":true,"format":"int32"},"foulsOffensive":{"description":"The number of offensive fouls","type":"integer","nullable":true,"format":"int32"},"foulsDrawn":{"description":"The number of times this entity has been fouled on","type":"integer","nullable":true,"format":"int32"},"foulsPersonal":{"description":"The number of personal fouls","type":"integer","nullable":true,"format":"int32"},"foulsPersonalAgainst":{"description":"The number of personal fouls by the opposing team","type":"integer","nullable":true,"format":"int32"},"foulsTechnical":{"description":"The number of technical fouls","type":"integer","nullable":true,"format":"int32"},"foulsTechnicalAgainst":{"description":"The number of technical fouls by the opposing team","type":"integer","nullable":true,"format":"int32"},"foulsTotal":{"description":"Total number of fouls (aggregate of persons)","type":"integer","format":"int32"},"foulsUnsportsmanlike":{"description":"The number of unsportsmanlike fouls","type":"integer","nullable":true,"format":"int32"},"indexOfSuccess":{"description":"Index of Success","type":"number","format":"float"},"leadChanges":{"description":"The number of times the lead changed","type":"integer","nullable":true,"format":"int32"},"minutes":{"description":"The number of minutes (in ISO8601 Duration format) that the team had players on the court. eg. PT1M30S equals 1 minute and 30 seconds","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"points":{"description":"Total number of points","type":"integer","format":"int32"},"pointsAgainst":{"description":"Points scored against","type":"integer","nullable":true,"format":"int32"},"pointsFastBreak":{"description":"Total of fast break points","type":"integer","format":"int32"},"pointsFastBreakAgainst":{"description":"Total of fast break points by the opposing team","type":"integer","format":"int32"},"pointsFastBreakAttempted":{"description":"Number of fast break points attempted","type":"integer","nullable":true,"format":"int32"},"pointsFastBreakMade":{"description":"Number of fast break points made","type":"integer","nullable":true,"format":"int32"},"pointsFromTurnover":{"description":"The number of points from turnovers","type":"integer","nullable":true,"format":"int32"},"pointsFromTurnoverAgainst":{"description":"The number of points from turnovers by the opposing team","type":"integer","nullable":true,"format":"int32"},"pointsInThePaint":{"description":"Total of points in the paint","type":"integer","format":"int32"},"pointsInThePaintAgainst":{"description":"Total of points in the paint by the opposing team","type":"integer","format":"int32"},"pointsInThePaintMade":{"description":"Number of points in the paint made","type":"integer","nullable":true,"format":"int32"},"pointsInThePaintAttempted":{"description":"Number of points in the paint attempted","type":"integer","nullable":true,"format":"int32"},"pointsFromBench":{"description":"Total of points from bench players","type":"integer","nullable":true,"format":"int32"},"pointsFromBenchAgainst":{"description":"Total of points from bench players by the opposing team","type":"integer","nullable":true,"format":"int32"},"pointsSecondChance":{"description":"Total of second chance points","type":"integer","format":"int32"},"pointsSecondChanceAgainst":{"description":"Total of second chance points by the opposing team","type":"integer","format":"int32"},"pointsSecondChanceAttempted":{"description":"Number of second chance points attempted","type":"integer","nullable":true,"format":"int32"},"pointsSecondChanceMade":{"description":"Number of second chance points made","type":"integer","nullable":true,"format":"int32"},"pointsTwoAttempted":{"description":"The number of two point shots attempted","type":"integer","nullable":true,"format":"int32"},"pointsTwoAttemptedAgainst":{"description":"The number of two point shots attempted by the opposing team","type":"integer","nullable":true,"format":"int32"},"pointsTwoMade":{"description":"The number of two point shots made","type":"integer","nullable":true,"format":"int32"},"pointsTwoMadeAgainst":{"description":"The number of two point shots made by the opposing team","type":"integer","nullable":true,"format":"int32"},"pointsTwoPercentage":{"description":"The percentage of successful two point shots","type":"number","format":"float"},"pointsTwoPercentageAgainst":{"description":"The percentage of successful two point shots","type":"number","format":"float"},"pointsThreeAttempted":{"description":"The number of three point shots attempted","type":"integer","nullable":true,"format":"int32"},"pointsThreeAttemptedAgainst":{"description":"The number of three point shots attempted by the opposing team","type":"integer","nullable":true,"format":"int32"},"pointsThreeMade":{"description":"The number of three point shots made","type":"integer","nullable":true,"format":"int32"},"pointsThreeMadeAgainst":{"description":"The number of three point shots made by the opposing team","type":"integer","nullable":true,"format":"int32"},"pointsThreePercentage":{"description":"The percentage of successful three point shots","type":"number","format":"float"},"pointsThreePercentageAgainst":{"description":"The percentage of successful three point shots by the opposing team","type":"number","format":"float"},"powerPlayPoints":{"description":"The number of points from power play","type":"integer","nullable":true,"format":"int32"},"powerPlayPointsAwarded":{"description":"The number of points being awarded from power play","type":"integer","nullable":true,"format":"int32"},"rebounds":{"description":"The total number of rebounds","type":"integer","format":"int32"},"reboundsAgainst":{"description":"The total number of rebounds by the opposing team","type":"integer","format":"int32"},"reboundsTeamTotal":{"description":"The total number of team rebounds","type":"integer","format":"int32"},"reboundsTeamTotalAgainst":{"description":"The total number of team rebounds by the opposing team","type":"integer","format":"int32"},"reboundsDefensive":{"description":"The number of total defensive rebounds","type":"integer","nullable":true,"format":"int32"},"reboundsDefensiveAgainst":{"description":"The number of total defensive rebounds by the opposing team","type":"integer","nullable":true,"format":"int32"},"reboundsTeamDefensive":{"description":"The number of team defensive rebounds","type":"integer","nullable":true,"format":"int32"},"reboundsTeamDefensiveAgainst":{"description":"The number of team defensive rebounds by the opposing team","type":"integer","nullable":true,"format":"int32"},"reboundsOffensive":{"description":"The number of total offensive rebounds","type":"integer","nullable":true,"format":"int32"},"reboundsOffensiveAgainst":{"description":"The number of total offensive rebounds by the opposing team","type":"integer","nullable":true,"format":"int32"},"reboundsTeamOffensive":{"description":"The number of team offensive rebounds","type":"integer","nullable":true,"format":"int32"},"reboundsTeamOffensiveAgainst":{"description":"The number of team offensive rebounds by the opposing team","type":"integer","nullable":true,"format":"int32"},"steals":{"description":"The number of steals","type":"integer","nullable":true,"format":"int32"},"stealsAgainst":{"description":"The number of steals by the opposing team","type":"integer","nullable":true,"format":"int32"},"timesScoreLevel":{"description":"The number of times the score was level","type":"integer","nullable":true,"format":"int32"},"timeInLead":{"description":"The number of minutes where this entity was in the lead.","anyOf":[{"type":"string","format":"duration"},{"type":"number","format":"float"}],"nullable":true},"timeoutsUsed":{"description":"The number of timeouts used by a team during the game","type":"integer","nullable":true,"format":"int32"},"trueShootingAttempts":{"description":"The number of true shooting attempts","type":"number","format":"float"},"trueShootingPercentage":{"description":"The true shooting percentage","type":"number","format":"float"},"turnovers":{"description":"The number of total turnovers","type":"integer","nullable":true,"format":"int32"},"turnoversAgainst":{"description":"The number of total turnovers by the opposing team","type":"integer","nullable":true,"format":"int32"},"turnoversTeam":{"description":"The number of team turnovers","type":"integer","nullable":true,"format":"int32"},"turnoversTeamAgainst":{"description":"The number of team turnovers by the opposing team","type":"integer","nullable":true,"format":"int32"},"turnoversPercentage":{"description":"The turnover percentage","type":"number","format":"float"}}},"periodId":{"description":"The identifier for the period\n>- `1` Period 1\n>- `2` Period 2\n>- `3` Period 3\n>- `4` Period 4\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","type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"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":"game_log_entity 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"},"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"},"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"},"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":{"/basketball/o/{organizationId}/statistics/for/entity/{entityId}/in/fixtures/seasons/{seasonId}/history":{"get":{"tags":["Team Match History"],"summary":"Match History for a team","description":"Return the Match History (based on statistics present) for a specific team in a season.","operationId":"gamelog_listentity","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Game_Log_Entity 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_EntityModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/added"},{"name":"entityId","description":"The unique identifier of the team","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$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"},{"$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":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$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/basketball/datacore-api-v1/team-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.