Release Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Basketball APIs

Event Creation Timestamp

Release DateFeeds AffectedBenefit
08/22/2024Play-by-Play

Push Events
We've added a created timestamp value for all events in a game.

Use this value to record exactly when each event was created in our database (ex. 2024-06-18T00:38:34Z).
"events": [
  {
    "id": "21ff5433-b9fe-4623-b34b-6452e86de3ec",
    "event_type": "lineupchange",
    "sequence": 1718671114093,
    "number": 5002,
    "clock_fraction": 0,
    "clock": "12:00",
    "clock_decimal": "12:00",
    "created": "2024-06-18T00:38:34Z",
    "updated": "2024-08-05T20:43:53Z",
    "wall_clock": "2024-06-18T00:38:34Z",
    "description": "Mavericks lineup change (Derrick Jones Jr., P.J. Washington, Luka Doncic, Kyrie Irving, Daniel Gafford)",
    "attribution": {
      "name": "Mavericks",
      "market": "Dallas",
      "reference": "1610612742",
      "id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
      "team_basket": "right"
    },
    "on_court": {
      "home": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Al Horford",
            "jersey_number": "42",
            "reference": "201143",
            "id": "cf3a87ec-c2f7-42e8-9698-6f8b2ba916a9"
          },
          {
            "full_name": "Jayson Tatum",
            "jersey_number": "0",
            "reference": "1628369",
            "id": "98136da3-452f-49dc-a794-1ee9c76443f2"
          },
          {
            "full_name": "Jrue Holiday",
            "jersey_number": "4",
            "reference": "201950",
            "id": "65700e81-3aa0-49a9-8a94-004f2cfb64e5"
          },
          {
            "full_name": "Derrick White",
            "jersey_number": "9",
            "reference": "1628401",
            "id": "9bcd5cff-4a1c-4454-89b6-a5899b0c6bcc"
          },
          {
            "full_name": "Jaylen Brown",
            "jersey_number": "7",
            "reference": "1627759",
            "id": "ffc5579c-783f-4d62-80ab-3c3dcb05a27d"
          }
        ]
      },
      "away": {
        "name": "Mavericks",
        "market": "Dallas",
        "reference": "1610612742",
        "id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Derrick Jones Jr.",
            "jersey_number": "55",
            "reference": "1627884",
            "id": "54cf6e06-9172-44b8-8d3b-ea1b6926553d"
          },
          {
            "full_name": "P.J. Washington",
            "jersey_number": "25",
            "reference": "1629023",
            "id": "6d7f4f2f-7ea7-4c56-8082-dfdce67f5487"
          },
          {
            "full_name": "Luka Doncic",
            "jersey_number": "77",
            "reference": "1629029",
            "id": "d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7"
          },
          {
            "full_name": "Kyrie Irving",
            "jersey_number": "11",
            "reference": "202681",
            "id": "dd146010-902b-4ad7-b98c-650d0363a2f0"
          },
          {
            "full_name": "Daniel Gafford",
            "jersey_number": "21",
            "reference": "1629655",
            "id": "52cd8137-c791-4569-ad70-433e25d34882"
          }
        ]
      }
    }
  },
  {
    "id": "494f17ed-b345-4182-8b37-a8886b184850",
    "event_type": "lineupchange",
    "sequence": 1718671114095,
    "number": 5002,
    "clock_fraction": 0,
    "clock": "12:00",
    "clock_decimal": "12:00",
    "created": "2024-06-18T00:38:34Z",
    "updated": "2024-08-05T20:43:51Z",
    "wall_clock": "2024-06-18T00:38:34Z",
    "description": "Celtics lineup change (Al Horford, Jayson Tatum, Jrue Holiday, Derrick White, Jaylen Brown)",
    "attribution": {
      "name": "Celtics",
      "market": "Boston",
      "reference": "1610612738",
      "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
      "team_basket": "left"
    },
    "on_court": {
      "home": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Al Horford",
            "jersey_number": "42",
            "reference": "201143",
            "id": "cf3a87ec-c2f7-42e8-9698-6f8b2ba916a9"
          },
          {
            "full_name": "Jayson Tatum",
            "jersey_number": "0",
            "reference": "1628369",
            "id": "98136da3-452f-49dc-a794-1ee9c76443f2"
          },
          {
            "full_name": "Jrue Holiday",
            "jersey_number": "4",
            "reference": "201950",
            "id": "65700e81-3aa0-49a9-8a94-004f2cfb64e5"
          },
          {
            "full_name": "Derrick White",
            "jersey_number": "9",
            "reference": "1628401",
            "id": "9bcd5cff-4a1c-4454-89b6-a5899b0c6bcc"
          },
          {
            "full_name": "Jaylen Brown",
            "jersey_number": "7",
            "reference": "1627759",
            "id": "ffc5579c-783f-4d62-80ab-3c3dcb05a27d"
          }
        ]
      },
      "away": {
        "name": "Mavericks",
        "market": "Dallas",
        "reference": "1610612742",
        "id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Derrick Jones Jr.",
            "jersey_number": "55",
            "reference": "1627884",
            "id": "54cf6e06-9172-44b8-8d3b-ea1b6926553d"
          },
          {
            "full_name": "P.J. Washington",
            "jersey_number": "25",
            "reference": "1629023",
            "id": "6d7f4f2f-7ea7-4c56-8082-dfdce67f5487"
          },
          {
            "full_name": "Luka Doncic",
            "jersey_number": "77",
            "reference": "1629029",
            "id": "d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7"
          },
          {
            "full_name": "Kyrie Irving",
            "jersey_number": "11",
            "reference": "202681",
            "id": "dd146010-902b-4ad7-b98c-650d0363a2f0"
          },
          {
            "full_name": "Daniel Gafford",
            "jersey_number": "21",
            "reference": "1629655",
            "id": "52cd8137-c791-4569-ad70-433e25d34882"
          }
        ]
      }
    }
  },
  {
    "id": "114d1d84-0f86-4c42-bf66-af79e12e2d4f",
    "event_type": "opentip",
    "sequence": 1718671116500,
    "number": 4,
    "clock_fraction": 0,
    "clock": "12:00",
    "clock_decimal": "12:00",
    "created": "2024-06-18T00:38:36Z",
    "updated": "2024-08-05T20:43:48Z",
    "wall_clock": "2024-06-18T00:38:36Z",
    "description": "Daniel Gafford vs. Al Horford (Jaylen Brown gains possession)",
    "attribution": {
      "name": "Celtics",
      "market": "Boston",
      "reference": "1610612738",
      "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
      "team_basket": "left"
    },
    "possession": {
      "name": "Celtics",
      "market": "Boston",
      "reference": "1610612738",
      "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c"
    },
    "on_court": {
      "home": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Al Horford",
            "jersey_number": "42",
            "reference": "201143",
            "id": "cf3a87ec-c2f7-42e8-9698-6f8b2ba916a9"
          },
          {
            "full_name": "Jayson Tatum",
            "jersey_number": "0",
            "reference": "1628369",
            "id": "98136da3-452f-49dc-a794-1ee9c76443f2"
          },
          {
            "full_name": "Jrue Holiday",
            "jersey_number": "4",
            "reference": "201950",
            "id": "65700e81-3aa0-49a9-8a94-004f2cfb64e5"
          },
          {
            "full_name": "Derrick White",
            "jersey_number": "9",
            "reference": "1628401",
            "id": "9bcd5cff-4a1c-4454-89b6-a5899b0c6bcc"
          },
          {
            "full_name": "Jaylen Brown",
            "jersey_number": "7",
            "reference": "1627759",
            "id": "ffc5579c-783f-4d62-80ab-3c3dcb05a27d"
          }
        ]
      },
      "away": {
        "name": "Mavericks",
        "market": "Dallas",
        "reference": "1610612742",
        "id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Derrick Jones Jr.",
            "jersey_number": "55",
            "reference": "1627884",
            "id": "54cf6e06-9172-44b8-8d3b-ea1b6926553d"
          },
          {
            "full_name": "P.J. Washington",
            "jersey_number": "25",
            "reference": "1629023",
            "id": "6d7f4f2f-7ea7-4c56-8082-dfdce67f5487"
          },
          {
            "full_name": "Luka Doncic",
            "jersey_number": "77",
            "reference": "1629029",
            "id": "d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7"
          },
          {
            "full_name": "Kyrie Irving",
            "jersey_number": "11",
            "reference": "202681",
            "id": "dd146010-902b-4ad7-b98c-650d0363a2f0"
          },
          {
            "full_name": "Daniel Gafford",
            "jersey_number": "21",
            "reference": "1629655",
            "id": "52cd8137-c791-4569-ad70-433e25d34882"
          }
        ]
      }
    }
  },
  {
    "id": "ed40ae31-f06c-45d7-8725-b52751411e8e",
    "event_type": "twopointmade",
    "sequence": 1718671132200,
    "number": 7,
    "clock_fraction": 0,
    "clock": "11:40",
    "clock_decimal": "11:40",
    "created": "2024-06-18T00:38:53Z",
    "updated": "2024-08-05T20:43:45Z",
    "wall_clock": "2024-06-18T00:38:52Z",
    "description": "Jrue Holiday makes two point driving layup (Jayson Tatum assists)",
    "qualifiers": [
      {
        "qualifier": "pointsinthepaint"
      }
    ],
    "attribution": {
      "name": "Celtics",
      "market": "Boston",
      "reference": "1610612738",
      "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
      "team_basket": "left"
    },
    "location": {
      "coord_x": 74,
      "coord_y": 295,
      "action_area": "underbasket"
    },
    "possession": {
      "name": "Mavericks",
      "market": "Dallas",
      "reference": "1610612742",
      "id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c"
    },
    "on_court": {
      "home": {
        "name": "Celtics",
        "market": "Boston",
        "reference": "1610612738",
        "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Al Horford",
            "jersey_number": "42",
            "reference": "201143",
            "id": "cf3a87ec-c2f7-42e8-9698-6f8b2ba916a9"
          },
          {
            "full_name": "Jayson Tatum",
            "jersey_number": "0",
            "reference": "1628369",
            "id": "98136da3-452f-49dc-a794-1ee9c76443f2"
          },
          {
            "full_name": "Jrue Holiday",
            "jersey_number": "4",
            "reference": "201950",
            "id": "65700e81-3aa0-49a9-8a94-004f2cfb64e5"
          },
          {
            "full_name": "Derrick White",
            "jersey_number": "9",
            "reference": "1628401",
            "id": "9bcd5cff-4a1c-4454-89b6-a5899b0c6bcc"
          },
          {
            "full_name": "Jaylen Brown",
            "jersey_number": "7",
            "reference": "1627759",
            "id": "ffc5579c-783f-4d62-80ab-3c3dcb05a27d"
          }
        ]
      },
      "away": {
        "name": "Mavericks",
        "market": "Dallas",
        "reference": "1610612742",
        "id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
        "players": [
          {
            "full_name": "Derrick Jones Jr.",
            "jersey_number": "55",
            "reference": "1627884",
            "id": "54cf6e06-9172-44b8-8d3b-ea1b6926553d"
          },
          {
            "full_name": "P.J. Washington",
            "jersey_number": "25",
            "reference": "1629023",
            "id": "6d7f4f2f-7ea7-4c56-8082-dfdce67f5487"
          },
          {
            "full_name": "Luka Doncic",
            "jersey_number": "77",
            "reference": "1629029",
            "id": "d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7"
          },
          {
            "full_name": "Kyrie Irving",
            "jersey_number": "11",
            "reference": "202681",
            "id": "dd146010-902b-4ad7-b98c-650d0363a2f0"
          },
          {
            "full_name": "Daniel Gafford",
            "jersey_number": "21",
            "reference": "1629655",
            "id": "52cd8137-c791-4569-ad70-433e25d34882"
          }
        ]
      }
    },
    "statistics": [
      {
        "type": "fieldgoal",
        "made": true,
        "shot_type": "layup",
        "shot_type_desc": "driving",
        "shot_distance": 1.01,
        "points": 2,
        "team": {
          "name": "Celtics",
          "market": "Boston",
          "reference": "1610612738",
          "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c"
        },
        "player": {
          "full_name": "Jrue Holiday",
          "jersey_number": "4",
          "reference": "201950",
          "id": "65700e81-3aa0-49a9-8a94-004f2cfb64e5"
        }
      },
      {
        "type": "assist",
        "team": {
          "name": "Celtics",
          "market": "Boston",
          "reference": "1610612738",
          "id": "583eccfa-fb46-11e1-82cb-f4ce4684ea4c"
        },
        "player": {
          "full_name": "Jayson Tatum",
          "jersey_number": "0",
          "reference": "1628369",
          "id": "98136da3-452f-49dc-a794-1ee9c76443f2"
        }
      }
    ]
  },

Update applies to: NBA v8, WNBA v8, NCAAMB v8, NCAAWB v8, NBA G League v8