GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NASCAR API - Timestamps for Flag Events

We've added timestamps for flag events in our NASCAR API. A created_at dateTime value will be present going forward for all race flag states. See below for sample data.


⭐ Benefit

Use the timestamps to get an accurate ordering of all NASCAR race flag events.


☑️ Sample Requests

  • Race Leaderboard - https://api.sportradar.com/nascar-ot3/sc/races/{race_id}/results.json

🔢 Versions


🔁 Endpoints Affected

  • Race Leaderboard

⚙️ Return Samples

    "flags":
    [
        {
            "sequence": 1,
            "lap": 0,
            "flag_state": "warmup",
            "created_at": "2026-02-12T23:31:19+00:00"
        },
        {
            "sequence": 2,
            "lap": 0,
            "flag_state": "green",
            "created_at": "2026-02-13T00:20:54+00:00"
        },
        {
            "sequence": 3,
            "lap": 45,
            "flag_state": "yellow",
            "created_at": "2026-02-13T00:57:12+00:00",
            "comments": "#4, 66 Stopped On Frontstretch"
        },
        {
            "sequence": 4,
            "lap": 48,
            "flag_state": "green",
            "created_at": "2026-02-13T01:04:18+00:00"
        },
        {
            "sequence": 5,
            "lap": 55,
            "flag_state": "yellow",
            "created_at": "2026-02-13T01:09:36+00:00",
            "comments": "#3, 17, 23, 24, 36 Incident Backstretch",
            "beneficiary": "66   "
        },
        {
            "sequence": 6,
            "lap": 60,
            "flag_state": "green",
            "created_at": "2026-02-13T01:20:36+00:00"
        },
        {
            "sequence": 7,
            "lap": 62,
            "flag_state": "yellow",
            "created_at": "2026-02-13T01:22:06+00:00",
            "comments": "#1, 7, 16, 66, 99 Incident Turn 3",
            "beneficiary": "     "
        },
        {
            "sequence": 8,
            "lap": 62,
            "flag_state": "finish",
            "created_at": "2026-02-13T01:22:18+00:00"
        }
    ],
    <flags>
        <flag sequence="1" lap="0" flag_state="warmup" created_at="2026-02-12T23:31:19+00:00">
    </flag>
        <flag sequence="2" lap="0" flag_state="green" created_at="2026-02-13T00:20:54+00:00">
    </flag>
        <flag sequence="3" lap="45" flag_state="yellow" created_at="2026-02-13T00:57:12+00:00">
            <comments>
                <![CDATA[#4, 66 Stopped On Frontstretch]]>
      
            </comments>
        </flag>
        <flag sequence="4" lap="48" flag_state="green" created_at="2026-02-13T01:04:18+00:00">
    </flag>
        <flag sequence="5" lap="55" flag_state="yellow" created_at="2026-02-13T01:09:36+00:00">
            <comments>
                <![CDATA[#3, 17, 23, 24, 36 Incident Backstretch]]>
      
            </comments>
            <beneficiary>
                <![CDATA[66   ]]>
      
            </beneficiary>
        </flag>
        <flag sequence="6" lap="60" flag_state="green" created_at="2026-02-13T01:20:36+00:00">
    </flag>
        <flag sequence="7" lap="62" flag_state="yellow" created_at="2026-02-13T01:22:06+00:00">
            <comments>
                <![CDATA[#1, 7, 16, 66, 99 Incident Turn 3]]>
      
            </comments>
            <beneficiary>
                <![CDATA[     ]]>
      
            </beneficiary>
        </flag>
        <flag sequence="8" lap="62" flag_state="finish" created_at="2026-02-13T01:22:18+00:00">
    </flag>
    </flags>