# Match PLAY BY PLAY

A match involves a number of events. These events aggregate to form a play-by-play. The play-by-play assigned to a match are controlled by these calls.

## Get a list play-by-play records for a match

> Return a list of play-by-play records for a match

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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_Pbp_EventModel":{"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 Fixture PBP Event 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"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"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"},"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"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event 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"},"flagged":{"name":"flagged","description":"Filter by events that are flagged for review","schema":{"type":"boolean"},"required":false,"in":"query"},"fromTimestamp":{"name":"fromTimestamp","description":"Where the date/time (UTC) this play-by-play event was sent >= this value","schema":{"type":"string","format":"date-time"},"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"},"pbplimit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":2000,"minimum":1,"default":1000},"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>- `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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":false,"in":"query"},"toTimestamp":{"name":"toTimestamp","description":"Where the date/time (UTC) this play-by-play event was sent <= this value","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/playbyplay":{"get":{"tags":["Match PLAY-BY-PLAY"],"summary":"Get a list play-by-play records for a match","description":"Return a list of play-by-play records for a match","operationId":"fixture_pbp_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp_Event 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_Pbp_EventModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$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/flagged"},{"$ref":"#/components/parameters/fromTimestamp"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/pbplimit"},{"$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/toTimestamp"}]}}}}
```

## Delete all play-by-play records for a match

> Delete all play-by-play records for a match

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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_PbpModel":{"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 fixture_pbp 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"},"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},"events":{"title":"Event details","description":"Event details","type":"object","nullable":true,"properties":{}},"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":"fixture_pbp 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"},"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"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/playbyplay":{"delete":{"tags":["Match PLAY-BY-PLAY"],"summary":"Delete all play-by-play records for a match","description":"Delete all play-by-play records for a match","operationId":"fixture_pbp_all_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp 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_PbpModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$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"}]}}}}
```

## Get a list of live play-by-play records for a match

> \
> &#x20;   Return a list of live play-by-play records for a match. This call will return records of matches\
> &#x20;   still in-progress if available.  If the match is complete this call operates the same as the non 'live'\
> &#x20;   route.\
> \
> &#x20;   Rate limited to 2 requests every minute - returns HTTP 429 Too Many Requests if called more often.\
> &#x20;  &#x20;

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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_Pbp_EventModel":{"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 Fixture PBP Event 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"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"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"},"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"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event 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"},"flagged":{"name":"flagged","description":"Filter by events that are flagged for review","schema":{"type":"boolean"},"required":false,"in":"query"},"fromTimestamp":{"name":"fromTimestamp","description":"Where the date/time (UTC) this play-by-play event was sent >= this value","schema":{"type":"string","format":"date-time"},"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"},"pbplimit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":2000,"minimum":1,"default":1000},"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>- `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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":false,"in":"query"},"toTimestamp":{"name":"toTimestamp","description":"Where the date/time (UTC) this play-by-play event was sent <= this value","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/playbyplay/live":{"get":{"tags":["Match PLAY-BY-PLAY"],"summary":"Get a list of live play-by-play records for a match","description":"\n    Return a list of live play-by-play records for a match. This call will return records of matches\n    still in-progress if available.  If the match is complete this call operates the same as the non 'live'\n    route.\n\n    Rate limited to 2 requests every minute - returns HTTP 429 Too Many Requests if called more often.\n    ","operationId":"fixture_pbp_list_live","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp_Event 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_Pbp_EventModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$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/flagged"},{"$ref":"#/components/parameters/fromTimestamp"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/pbplimit"},{"$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/toTimestamp"}]}}}}
```

## Get a list of flagged play-by-play records

> Return a list of play-by-play records that have been flagged across all matches

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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:admin"]}],"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_Pbp_EventModel":{"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 Fixture PBP Event 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"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"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"},"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"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event 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"},"fromTimestamp":{"name":"fromTimestamp","description":"Where the date/time (UTC) this play-by-play event was sent >= this value","schema":{"type":"string","format":"date-time"},"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"},"pbplimit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":2000,"minimum":1,"default":1000},"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>- `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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":false,"in":"query"},"seasonId":{"name":"seasonId","description":"The unique identifier of the season","schema":{"type":"string","format":"uuid"},"required":false,"in":"query"},"fixtureStatus":{"name":"status","description":"Match status. Can specify multiple, delimited by comma.\n>- `ABANDONED` Abandoned\n>- `ABOUT_TO_START` About to Start\n>- `BYE` Bye\n>- `CANCELLED` Cancelled\n>- `CONFIRMED` Confirmed\n>- `DRAFT` Draft\n>- `FINISHED` Finished\n>- `IF_NEEDED` If Needed\n>- `IN_PROGRESS` In Progress\n>- `ON_PITCH` On Pitch\n>- `PENDING` Pending\n>- `POSTPONED` Postponed\n>- `SCHEDULED` Scheduled\n>- `WARM_UP` Warm Up\n","schema":{"type":"string","enum":["SCHEDULED","BYE","PENDING","IN_PROGRESS","FINISHED","CONFIRMED","POSTPONED","CANCELLED","ABANDONED","IF_NEEDED","WARM_UP","DRAFT","ON_PITCH","ABOUT_TO_START"],"maxLength":200},"required":false,"in":"query"},"toTimestamp":{"name":"toTimestamp","description":"Where the date/time (UTC) this play-by-play event was sent <= this value","schema":{"type":"string","format":"date-time"},"required":false,"in":"query"}}},"paths":{"/basketball33/o/{organizationId}/playbyplay/flagged":{"get":{"tags":["Match PLAY-BY-PLAY"],"summary":"Get a list of flagged play-by-play records","description":"Return a list of play-by-play records that have been flagged across all matches","operationId":"fixture_pbp_flagged_list","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp_Event 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_Pbp_EventModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fromTimestamp"},{"$ref":"#/components/parameters/hideNull"},{"$ref":"#/components/parameters/include"},{"$ref":"#/components/parameters/includeTotalCount"},{"$ref":"#/components/parameters/pbplimit"},{"$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/seasonId"},{"$ref":"#/components/parameters/fixtureStatus"},{"$ref":"#/components/parameters/toTimestamp"}]}}}}
```

## Get a full list of match events, suitable for subsequent import.

> Includes play-by-play and setup events for a match

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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:admin"]}],"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"}}}}}},"SuccessModel":{"type":"object","additionalProperties":false,"properties":{"success":{"description":"Was the call a success?","type":"boolean"}},"title":" 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"},"includeTotalCount":{"name":"includeTotalCount","description":"Include the total number of records matching the filters.","schema":{"type":"boolean"},"required":false,"in":"query"},"pbplimit":{"name":"limit","description":"The maximum number of records to return. See [Pagination](#section/Introduction/Pagination) for more information.","schema":{"type":"integer","format":"int32","maximum":2000,"minimum":1,"default":1000},"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"},"onlySetup":{"name":"onlySetup","description":"Include only setup events when exporting?","schema":{"type":"boolean"},"required":false,"in":"query"},"periodId":{"name":"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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":false,"in":"query"},"withScores":{"name":"withScores","description":"Include scores in exported events?","schema":{"type":"boolean"},"required":false,"in":"query"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/events/export":{"get":{"tags":["Match PLAY-BY-PLAY"],"summary":"Get a full list of match events, suitable for subsequent import.","description":"Includes play-by-play and setup events for a match","operationId":"fixture_pbp_export","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Success 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/SuccessModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$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/pbplimit"},{"$ref":"#/components/parameters/offset"},{"$ref":"#/components/parameters/onlySetup"},{"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/withScores"}]}}}}
```

## Add or Update historical play-by-play records for a match

> \
> &#x20;   Depending on primary keys, Add a match play-by-play or update an existing record.  This call operates\
> &#x20;   in bulk for all events in a specific period. \<b>Note:\</b>This call should only be used to import historical data.\
> &#x20;   Changes to current/live data show be peformed only via your live capture software.  If this call is used data may\
> &#x20;   become invalid as statistics/actions may not be recalculated.\
> &#x20;  &#x20;

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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:admin"]}],"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"}}}}}},"SuccessModel":{"type":"object","additionalProperties":false,"properties":{"success":{"description":"Was the call a success?","type":"boolean"}},"title":" 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":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/events/import":{"post":{"tags":["Match PLAY-BY-PLAY"],"summary":"Add or Update historical play-by-play records for a match","description":"\n    Depending on primary keys, Add a match play-by-play or update an existing record.  This call operates\n    in bulk for all events in a specific period. <b>Note:</b>This call should only be used to import historical data.\n    Changes to current/live data show be peformed only via your live capture software.  If this call is used data may\n    become invalid as statistics/actions may not be recalculated.\n    ","operationId":"fixture_pbp_events_import","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Success 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/SuccessModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$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"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"}]}}}}
```

## Add an individual a match play-by-play event

> Add a specific period play-by-play from a match event

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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:admin"]}],"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_Pbp_EventModel":{"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 Fixture PBP Event 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"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"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"},"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"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event 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"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/periods/{periodId}/playbyplay":{"post":{"tags":["Match PLAY-BY-PLAY"],"summary":"Add an individual a match play-by-play event","description":"Add a specific period play-by-play from a match event","operationId":"fixture_pbp_event_add","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp_Event 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_Pbp_EventModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$ref":"#/components/parameters/external"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":true,"in":"path"},{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"fixtureId":{"description":"The unique identifier of the match","type":"string","format":"uuid"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event post body"}}}}}}}}
```

## Delete a match play-by-play

> Delete a specific period play-by-play from a match

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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_PbpModel":{"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 fixture_pbp 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"},"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},"events":{"title":"Event details","description":"Event details","type":"object","nullable":true,"properties":{}},"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":"fixture_pbp 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"},"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"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/periods/{periodId}/playbyplay":{"delete":{"tags":["Match PLAY-BY-PLAY"],"summary":"Delete a match play-by-play","description":"Delete a specific period play-by-play from a match","operationId":"fixture_pbp_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp 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_PbpModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"$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"},{"name":"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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":true,"in":"path"},{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"}]}}}}
```

## Update an individual a match play-by-play event

> Update a specific period play-by-play from a match event

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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:admin"]}],"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_Pbp_EventModel":{"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 Fixture PBP Event 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"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"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"},"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"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event 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"}}},"paths":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/periods/{periodId}/playbyplay/{eventId}":{"put":{"tags":["Match PLAY-BY-PLAY"],"summary":"Update an individual a match play-by-play event","description":"Update a specific period play-by-play from a match event","operationId":"fixture_pbp_event_update","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp_Event 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_Pbp_EventModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"eventId","description":"The unique identifier of an event in a match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$ref":"#/components/parameters/external"},{"name":"fixtureId","description":"The unique identifier of the match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":true,"in":"path"},{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"entityId":{"description":"The unique identifier of the team","type":"string","format":"uuid"},"personId":{"description":"The unique identifier of the person","type":"string","format":"uuid"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event put body"}}}}}}}}
```

## Delete a match play-by-play event

> Delete a specific period play-by-play from a match event

```json
{"openapi":"3.0.0","info":{"title":"DataCore API  - 3x3 basketball3","version":"v1"},"tags":[{"name":"Match PLAY-BY-PLAY","description":"A match involves a number of events. These events aggregate to form a play-by-play.  The play-by-play assigned to a match are controlled by these calls.\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:admin"]}],"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_Pbp_EventModel":{"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 Fixture PBP Event 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"},"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},"events":{},"class":{"description":"The class of the event\n>- `clock` Information about the current status of the clock match\n>- `sport` A sporting action that relates to the running of the match\n","type":"string","enum":["sport","clock"],"maxLength":100,"default":"sport"},"eventType":{"description":"See [Event Types](http://developer.connect.sportradar.com/datacore/streaming.html#section/Message-Types/event) for more information","type":"string","maxLength":100},"eventId":{"description":"Unique identifier of this event","type":"string","format":"uuid"},"playId":{"description":"Unique identifier of this play (group of events)","type":"string","format":"uuid"},"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"},"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"},"subType":{"description":"The Sub Type of event. See <b>Streaming API</b> documenation for more information.","type":"string","maxLength":100},"options":{},"received":{"description":"The UNIX timestamp when the event was received.","type":"integer","format":"int32"},"status":{"description":"The status of this message.  Options are `added` (Default); `updated` - meaning the content of this event has been edited; `deleted` - meaning this event has been deleted; `enriched` - meaning further information has been added to the event (not changed).","type":"string"},"success":{"description":"Whether the action was successful","type":"boolean"},"x":{"description":"The x co-ordinate of the event. Represented as percentage from left (0) to right (100).","type":"number","format":"float"},"y":{"description":"The y co-ordinate of the event. Represented as precentage from top (0) to bottom (100).","type":"number","format":"float"},"z":{"description":"The z co-ordinate of the event. Represented as precentage from ground (0) to ceiling (100).","type":"number","format":"float"},"clock":{"description":"The time on the clock when the event occurred. ISO 8601 format. PTmmMss.ccS","type":"string"},"shotClock":{"description":"The time on the shot clock when the event occurred. ISO 8601 format. PTss.ccS","type":"string"},"eventTime":{"description":"The date/time (UTC) this event occurred. For inserted actions, this should be the time the action would have occurred, not the time of insertion.","type":"string","format":"date-time"},"officialId":{"description":"The unique ID of the official making this decision","type":"string","format":"uuid"},"zone":{"description":"See [Event Types]() for more information","type":"string","maxLength":50},"scores":{"title":"Current scores","description":"The current scores","type":"object","nullable":true,"additionalProperties":{"description":"The current score of the entity (given by the key).  For insertions this should still be the current (maximum) score (not the score at the time of event being inserted)","type":"string","maxLength":50}},"flagged":{"description":"This event has been flagged for further review and may be changed later","type":"boolean"},"highlight":{"description":"This event may be a highlight of the game.","type":"boolean"},"timestamp":{"description":"The date/time (UTC) this event was sent.","type":"string","format":"date-time"},"clientType":{"description":"Type of the client that sent the event","type":"string","maxLength":200},"clientId":{"description":"ID of the client that sent the event","type":"string","maxLength":200},"sport":{"description":"Sport one letter code","type":"string","maxLength":1},"topic":{"description":"MQTT topic where the event was sent","type":"string","maxLength":200},"type":{"description":"Type of the event message","type":"string","maxLength":100},"sequence":{"description":"Client event sequence number","type":"integer","format":"int32","nullable":true}},"title":"Fixture PBP Event 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":{"/basketball33/o/{organizationId}/fixtures/{fixtureId}/periods/{periodId}/playbyplay/{eventId}":{"delete":{"tags":["Match PLAY-BY-PLAY"],"summary":"Delete a match play-by-play event","description":"Delete a specific period play-by-play from a match event","operationId":"fixture_pbp_event_delete","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"object","title":"Fixture_Pbp_Event 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_Pbp_EventModel"}}}}}}},"default":{"$ref":"#/components/responses/ErrorResponse"}},"parameters":[{"name":"eventId","description":"The unique identifier of an event in a match","schema":{"type":"string","format":"uuid"},"required":true,"in":"path"},{"$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"},{"name":"organizationId","description":"The unique identifier of the organization","schema":{"type":"string","minLength":5,"maxLength":5},"required":true,"in":"path"},{"name":"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","schema":{"type":"integer","format":"int32","enum":[1,2,3,4,11,12,13,14,15,16]},"required":true,"in":"path"},{"name":"section","description":"The section of the period (sub-period)","schema":{"type":"string","maxLength":100},"required":false,"in":"query"}]}}}}
```


---

# 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/3x3-basketball/datacore-api-v1/match-play-by-play.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.