--- updatedAt: 2025-08-18T20:43:59.000Z agentTools: siteIndex: https://developer.sportradar.com/llms.txt projectIndex: https://developer.sportradar.com/basketball/v3/llms.txt --- # Play-By-Play **NCAAMB Play-By-Play** Detailed, real-time information on every team possession and game event. ### Update Frequency This endpoint will update to a 2s TTL (time to live) upon a game moving to **inprogress**. Upon **closed**, it will transfer to 120s. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "ncaa-mens-basketball", "version": "3" }, "servers": [ { "url": "https://api.sportradar.com/ncaamb/" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "query", "name": "api_key" } } }, "security": [ { "sec0": [] } ], "paths": { "/{access_level}/v3/{language_code}/games/{game_id}/pbp.{format}": { "get": { "summary": "Play-By-Play", "description": "**NCAAMB Play-By-Play** Detailed, real-time information on every team possession and game event.", "operationId": "ncaamb-play-by-play", "parameters": [ { "name": "access_level", "in": "path", "description": "The access level of your API key", "schema": { "type": "string", "enum": [ "trial", "production" ], "default": "trial" }, "required": true }, { "name": "language_code", "in": "path", "description": "2 letter code for supported language: en (English)", "schema": { "type": "string", "enum": [ "en" ], "default": "en" }, "required": true }, { "name": "game_id", "in": "path", "description": "ID of a given game", "schema": { "type": "string", "default": "0d8418c4-2815-4548-831b-7d4ed04faa8a" }, "required": true }, { "name": "format", "in": "path", "description": "Format returned", "schema": { "type": "string", "enum": [ "json", "xml" ], "default": "json" }, "required": true } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"id\": \"44975fe8-6ce4-4d0a-b491-90a9bb9d9047\",\n \"title\": \"South Regional - Sweet 16 - Game 1\",\n \"status\": \"closed\",\n \"coverage\": \"full\",\n \"neutral_site\": true,\n \"scheduled\": \"2023-03-24T22:30:00+00:00\",\n \"conference_game\": false,\n \"attendance\": 20289,\n \"lead_changes\": 9,\n \"times_tied\": 8,\n \"clock\": \"00:00\",\n \"half\": 2,\n \"track_on_court\": true,\n \"entry_mode\": \"LDE\",\n \"clock_decimal\": \"00:00\",\n \"time_zones\": {\n \"venue\": \"US/Eastern\",\n \"home\": \"US/Central\",\n \"away\": \"US/Pacific\"\n },\n \"home\": {\n \"name\": \"Crimson Tide\",\n \"alias\": \"ALA\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\",\n \"points\": 64,\n \"rank\": 1,\n \"remaining_timeouts\": 2\n },\n \"periods\": [\n {\n \"type\": \"half\",\n \"id\": \"c8d823e0-99c6-4213-a661-549352a11034\",\n \"number\": 2,\n \"sequence\": 2,\n \"scoring\": {\n \"times_tied\": 2,\n \"lead_changes\": 2,\n \"home\": {\n \"name\": \"Crimson Tide\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\",\n \"points\": 41\n },\n \"away\": {\n \"name\": \"Aztecs\",\n \"market\": \"San Diego State\",\n \"id\": \"e6914f16-ca37-4d2e-ba26-a425910283e2\",\n \"points\": 43\n }\n },\n \"events\": [\n {\n \"id\": \"2bc07042-1c38-4421-a0c7-97b00c46e2cb\",\n \"clock\": \"19:05\",\n \"updated\": \"2023-03-24T23:46:53Z\",\n \"description\": \"Brandon Miller makes three point jump shot (Mark Sears assists)\",\n \"sequence\": 1679701613686,\n \"home_points\": 26,\n \"away_points\": 28,\n \"clock_decimal\": \"19:05\",\n \"event_type\": \"threepointmade\",\n \"attribution\": {\n \"name\": \"Crimson Tide\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\",\n \"team_basket\": \"left\"\n },\n \"location\": {\n \"coord_x\": 318,\n \"coord_y\": 434\n },\n \"possession\": {\n \"name\": \"Aztecs\",\n \"market\": \"San Diego State\",\n \"id\": \"e6914f16-ca37-4d2e-ba26-a425910283e2\"\n },\n \"on_court\": {\n \"home\": {\n \"name\": \"Crimson Tide\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\",\n \"players\": [\n {\n \"full_name\": \"Brandon Miller\",\n \"jersey_number\": \"24\",\n \"id\": \"4da60208-807f-409e-8881-998ad5627857\"\n }\n ]\n },\n \"away\": {\n \"name\": \"Aztecs\",\n \"market\": \"San Diego State\",\n \"id\": \"e6914f16-ca37-4d2e-ba26-a425910283e2\",\n \"players\": [\n {\n \"full_name\": \"Nathan Mensah\",\n \"jersey_number\": \"31\",\n \"id\": \"921108f6-e306-432a-b9e8-9e729b8834e1\"\n }\n ]\n }\n },\n \"statistics\": [\n {\n \"type\": \"assist\",\n \"team\": {\n \"name\": \"Crimson Tide\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\"\n },\n \"player\": {\n \"full_name\": \"Mark Sears\",\n \"jersey_number\": \"1\",\n \"id\": \"ff7b20b2-ea27-4938-b6ca-ae27fabafde5\"\n }\n },\n {\n \"type\": \"fieldgoal\",\n \"made\": true,\n \"shot_type\": \"jump shot\",\n \"three_point_shot\": true,\n \"points\": 3,\n \"team\": {\n \"name\": \"Crimson Tide\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\"\n },\n \"player\": {\n \"full_name\": \"Brandon Miller\",\n \"jersey_number\": \"24\",\n \"id\": \"4da60208-807f-409e-8881-998ad5627857\"\n }\n }\n ]\n },\n {\n \"id\": \"8009b3f6-1f62-4997-a150-745080c93bc8\",\n \"clock\": \"18:47\",\n \"updated\": \"2023-03-24T23:47:13Z\",\n \"description\": \"Matt Bradley misses three point jump shot\",\n \"sequence\": 1679701633415,\n \"home_points\": 26,\n \"away_points\": 28,\n \"clock_decimal\": \"18:47\",\n \"event_type\": \"threepointmiss\",\n \"attribution\": {\n \"name\": \"Aztecs\",\n \"market\": \"San Diego State\",\n \"id\": \"e6914f16-ca37-4d2e-ba26-a425910283e2\",\n \"team_basket\": \"right\"\n },\n \"location\": {\n \"coord_x\": 824,\n \"coord_y\": 384\n },\n \"on_court\": {\n \"home\": {\n \"name\": \"Crimson Tide\",\n \"market\": \"Alabama\",\n \"id\": \"c2104cdc-c83d-40d2-a3cd-df986e29f5d3\",\n \"players\": [\n {\n \"full_name\": \"Brandon Miller\",\n \"jersey_number\": \"24\",\n \"id\": \"4da60208-807f-409e-8881-998ad5627857\"\n }\n ]\n },\n \"away\": {\n \"name\": \"Aztecs\",\n \"market\": \"San Diego State\",\n \"id\": \"e6914f16-ca37-4d2e-ba26-a425910283e2\",\n \"players\": [\n {\n \"full_name\": \"Nathan Mensah\",\n \"jersey_number\": \"31\",\n \"id\": \"921108f6-e306-432a-b9e8-9e729b8834e1\"\n }\n ]\n }\n },\n \"statistics\": [\n {\n \"type\": \"fieldgoal\",\n \"made\": false,\n \"shot_type\": \"jump shot\",\n \"three_point_shot\": true,\n \"team\": {\n \"name\": \"Aztecs\",\n \"market\": \"San Diego State\",\n \"id\": \"e6914f16-ca37-4d2e-ba26-a425910283e2\"\n },\n \"player\": {\n \"full_name\": \"Matt Bradley\",\n \"jersey_number\": \"20\",\n \"id\": \"bc78fcdd-2c4d-4c92-bd8d-305572e5f209\"\n }\n }\n ]\n }\n ]\n }\n ],\n \"deleted_events\": [\n {\n \"id\": \"a2213e2a-688f-4c2f-9c02-e335cb1eb508\"\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "44975fe8-6ce4-4d0a-b491-90a9bb9d9047" }, "title": { "type": "string", "example": "South Regional - Sweet 16 - Game 1" }, "status": { "type": "string", "example": "closed" }, "coverage": { "type": "string", "example": "full" }, "neutral_site": { "type": "boolean", "example": true, "default": true }, "scheduled": { "type": "string", "example": "2023-03-24T22:30:00+00:00" }, "conference_game": { "type": "boolean", "example": false, "default": true }, "attendance": { "type": "integer", "example": 20289, "default": 0 }, "lead_changes": { "type": "integer", "example": 9, "default": 0 }, "times_tied": { "type": "integer", "example": 8, "default": 0 }, "clock": { "type": "string", "example": "00:00" }, "half": { "type": "integer", "example": 2, "default": 0 }, "track_on_court": { "type": "boolean", "example": true, "default": true }, "entry_mode": { "type": "string", "example": "LDE" }, "clock_decimal": { "type": "string", "example": "00:00" }, "time_zones": { "type": "object", "properties": { "venue": { "type": "string", "example": "US/Eastern" }, "home": { "type": "string", "example": "US/Central" }, "away": { "type": "string", "example": "US/Pacific" } } }, "home": { "type": "object", "properties": { "name": { "type": "string", "example": "Crimson Tide" }, "alias": { "type": "string", "example": "ALA" }, "market": { "type": "string", "example": "Alabama" }, "id": { "type": "string", "example": "c2104cdc-c83d-40d2-a3cd-df986e29f5d3" }, "points": { "type": "integer", "example": 64, "default": 0 }, "rank": { "type": "integer", "example": 1, "default": 0 }, "remaining_timeouts": { "type": "integer", "example": 2, "default": 0 } } }, "periods": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "example": "half" }, "id": { "type": "string", "example": "c8d823e0-99c6-4213-a661-549352a11034" }, "number": { "type": "integer", "example": 2, "default": 0 }, "sequence": { "type": "integer", "example": 2, "default": 0 }, "scoring": { "type": "object", "properties": { "times_tied": { "type": "integer", "example": 2, "default": 0 }, "lead_changes": { "type": "integer", "example": 2, "default": 0 }, "home": { "type": "object", "properties": { "name": { "type": "string", "example": "Crimson Tide" }, "market": { "type": "string", "example": "Alabama" }, "id": { "type": "string", "example": "c2104cdc-c83d-40d2-a3cd-df986e29f5d3" }, "points": { "type": "integer", "example": 41, "default": 0 } } }, "away": { "type": "object", "properties": { "name": { "type": "string", "example": "Aztecs" }, "market": { "type": "string", "example": "San Diego State" }, "id": { "type": "string", "example": "e6914f16-ca37-4d2e-ba26-a425910283e2" }, "points": { "type": "integer", "example": 43, "default": 0 } } } } }, "events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "2bc07042-1c38-4421-a0c7-97b00c46e2cb" }, "clock": { "type": "string", "example": "19:05" }, "updated": { "type": "string", "example": "2023-03-24T23:46:53Z" }, "description": { "type": "string", "example": "Brandon Miller makes three point jump shot (Mark Sears assists)" }, "sequence": { "type": "integer", "example": 1679701613686, "default": 0 }, "home_points": { "type": "integer", "example": 26, "default": 0 }, "away_points": { "type": "integer", "example": 28, "default": 0 }, "clock_decimal": { "type": "string", "example": "19:05" }, "event_type": { "type": "string", "example": "threepointmade" }, "attribution": { "type": "object", "properties": { "name": { "type": "string", "example": "Crimson Tide" }, "market": { "type": "string", "example": "Alabama" }, "id": { "type": "string", "example": "c2104cdc-c83d-40d2-a3cd-df986e29f5d3" }, "team_basket": { "type": "string", "example": "left" } } }, "location": { "type": "object", "properties": { "coord_x": { "type": "integer", "example": 318, "default": 0 }, "coord_y": { "type": "integer", "example": 434, "default": 0 } } }, "possession": { "type": "object", "properties": { "name": { "type": "string", "example": "Aztecs" }, "market": { "type": "string", "example": "San Diego State" }, "id": { "type": "string", "example": "e6914f16-ca37-4d2e-ba26-a425910283e2" } } }, "on_court": { "type": "object", "properties": { "home": { "type": "object", "properties": { "name": { "type": "string", "example": "Crimson Tide" }, "market": { "type": "string", "example": "Alabama" }, "id": { "type": "string", "example": "c2104cdc-c83d-40d2-a3cd-df986e29f5d3" }, "players": { "type": "array", "items": { "type": "object", "properties": { "full_name": { "type": "string", "example": "Brandon Miller" }, "jersey_number": { "type": "string", "example": "24" }, "id": { "type": "string", "example": "4da60208-807f-409e-8881-998ad5627857" } } } } } }, "away": { "type": "object", "properties": { "name": { "type": "string", "example": "Aztecs" }, "market": { "type": "string", "example": "San Diego State" }, "id": { "type": "string", "example": "e6914f16-ca37-4d2e-ba26-a425910283e2" }, "players": { "type": "array", "items": { "type": "object", "properties": { "full_name": { "type": "string", "example": "Nathan Mensah" }, "jersey_number": { "type": "string", "example": "31" }, "id": { "type": "string", "example": "921108f6-e306-432a-b9e8-9e729b8834e1" } } } } } } } }, "statistics": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "example": "assist" }, "team": { "type": "object", "properties": { "name": { "type": "string", "example": "Crimson Tide" }, "market": { "type": "string", "example": "Alabama" }, "id": { "type": "string", "example": "c2104cdc-c83d-40d2-a3cd-df986e29f5d3" } } }, "player": { "type": "object", "properties": { "full_name": { "type": "string", "example": "Mark Sears" }, "jersey_number": { "type": "string", "example": "1" }, "id": { "type": "string", "example": "ff7b20b2-ea27-4938-b6ca-ae27fabafde5" } } } } } } } } } } } }, "deleted_events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "a2213e2a-688f-4c2f-9c02-e335cb1eb508" } } } } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```