DFSContestsUserLineups_DfsContestUserLineupsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/stat-api-com/json-schema/stat-api-com-dfscontests-user-lineups-dfs-contest-user-lineups-response-schema.json",
  "title": "DFSContestsUserLineups_DfsContestUserLineupsResponse",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/stat-api-com-openapi.json#/components/schemas/DFSContestsUserLineups_DfsContestUserLineupsResponse",
  "properties": {
    "_metadata": {
      "description": "Sent only on a capped answer (fewer rows than exist for this caller): the plan that opens the rest. A full answer (DFS access, or a marquee contest of at most 100 entries) has no such key. A marquee contest of more than 100 entries carries it.",
      "properties": {
        "message": {
          "description": "What the plan opens.",
          "type": "string"
        },
        "required_tier": {
          "description": "pro.",
          "type": "string"
        },
        "total_actual_records": {
          "description": "The user's lineups in the contest.",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "required_tier",
        "message",
        "total_actual_records"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "access": {
      "description": "What this caller may read.",
      "properties": {
        "exposure_per_user": {
          "description": "Always null: no plan caps the exposure rows of an open user.",
          "type": [
            "integer",
            "null"
          ]
        },
        "exposure_total": {
          "description": "The user's exposure rows. Null on the standings route and when locked.",
          "type": [
            "integer",
            "null"
          ]
        },
        "full": {
          "description": "True when every row and value is sent: DFS access only (a marquee contest stops at row 100).",
          "type": "boolean"
        },
        "hidden_rows": {
          "description": "Exposure rows sent in hide mode (0 with DFS access and on the standings route).",
          "type": "integer"
        },
        "lineups_per_user": {
          "description": "Always null: no plan caps the lineups of an open user.",
          "type": [
            "integer",
            "null"
          ]
        },
        "lineups_total": {
          "description": "The user's lineups in the contest. Null on the standings route.",
          "type": [
            "integer",
            "null"
          ]
        },
        "locked": {
          "description": "True when the plan withholds this response's exposure, lineup and seat rows.",
          "type": "boolean"
        },
        "open_rows": {
          "description": "Standings rows whose users open: 5 on the Free plan, 100 on a marquee contest. Null with DFS access.",
          "type": [
            "integer",
            "null"
          ]
        },
        "plan": {
          "description": "\"pro\" with DFS access; \"flagship\" on a marquee contest for anyone else (GET /api/v1/dfs/marquee): the first 100 standings rows and every value of the users with an entry in them, no CSV; else \"free\" (the first 5 standings rows and hide mode).",
          "enum": [
            "pro",
            "free",
            "flagship"
          ],
          "type": "string"
        }
      },
      "required": [
        "plan",
        "full",
        "locked",
        "hidden_rows"
      ],
      "type": "object"
    },
    "analysis": {
      "description": "How this user built the lineups, worked out once on the server from the user's lineups and the pool (the page works out none of it). Null in hide mode (Free, off the flagships), when the user is locked, and when the user has no lineup.",
      "properties": {
        "dispersion": {
          "description": "How far apart the lineups are. The pair numbers are null for a user with 1 lineup and for a user with more than 500 lineups.",
          "properties": {
            "closest_twin_avg": {
              "description": "How many players a lineup differs by from the lineup most like it, averaged over the lineups, rounded to 2 decimals.",
              "format": "double",
              "type": [
                "number",
                "null"
              ]
            },
            "closest_twin_min": {
              "description": "The least number of players any lineup differs by from the lineup most like it.",
              "type": [
                "integer",
                "null"
              ]
            },
            "most_used_lineups": {
              "description": "The most lineups that hold one player.",
              "type": "integer"
            },
            "most_used_pct": {
              "description": "That count as a percent of the user's lineups, rounded to 1 decimal.",
              "format": "double",
              "type": "number"
            },
            "shared_avg": {
              "description": "Players two lineups share, averaged over every pair of the user's lineups, rounded to 2 decimals.",
              "format": "double",
              "type": [
                "number",
                "null"
              ]
            },
            "shared_max": {
              "description": "The most players two lineups share.",
              "type": [
                "integer",
                "null"
              ]
            },
            "shared_min": {
              "description": "The fewest players two lineups share.",
              "type": [
                "integer",
                "null"
              ]
            }
          },
          "required": [
            "most_used_lineups",
            "most_used_pct"
          ],
          "type": "object"
        },
        "lineups": {
          "description": "The user's lineups this block counts.",
          "type": "integer"
        },
        "ownership": {
          "description": "The sum of the seats' field ownership per lineup (`lineups[].total_ownership`), in percent, rounded to 1 decimal. Null when no lineup has it.",
          "properties": {
            "avg": {
              "description": "The average.",
              "format": "double",
              "type": "number"
            },
            "lineups": {
              "description": "The lineups that have the value.",
              "type": "integer"
            },
            "max": {
              "description": "The highest.",
              "format": "double",
              "type": "number"
            },
            "min": {
              "description": "The lowest.",
              "format": "double",
              "type": "number"
            }
          },
          "required": [
            "min",
            "avg",
            "max",
            "lineups"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "salary": {
          "description": "The salary used per lineup (`lineups[].salary_used`). Null when no lineup has it.",
          "properties": {
            "avg": {
              "description": "The average, rounded to a whole number.",
              "format": "double",
              "type": "number"
            },
            "lineups": {
              "description": "The lineups that have the value.",
              "type": "integer"
            },
            "max": {
              "description": "The highest.",
              "format": "double",
              "type": "number"
            },
            "min": {
              "description": "The lowest.",
              "format": "double",
              "type": "number"
            }
          },
          "required": [
            "min",
            "avg",
            "max",
            "lineups"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "stacks": {
          "description": "The stacks, by the same QB-stack rule as `stack`. Null on a contest that is not a classic NFL contest.",
          "properties": {
            "bring_back_teams": {
              "description": "Lineups with a bring-back by the bring-back team, most lineups first, then by team.",
              "items": {
                "properties": {
                  "lineups": {
                    "description": "Lineups with a bring-back from that team.",
                    "type": "integer"
                  },
                  "team": {
                    "description": "The team code.",
                    "type": "string"
                  }
                },
                "required": [
                  "team",
                  "lineups"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "distinct_qbs": {
              "description": "The different QBs over the lineups.",
              "type": "integer"
            },
            "qb_plus_1": {
              "description": "Lineups whose QB has exactly 1 teammate (the defense is no teammate).",
              "type": "integer"
            },
            "qb_plus_2": {
              "description": "Lineups whose QB has exactly 2 teammates.",
              "type": "integer"
            },
            "qb_plus_3_or_more": {
              "description": "Lineups whose QB has 3 or more teammates.",
              "type": "integer"
            },
            "stack_teams": {
              "description": "QB stacks by the QB's team, most lineups first, then by team.",
              "items": {
                "properties": {
                  "lineups": {
                    "description": "QB stacks of that team.",
                    "type": "integer"
                  },
                  "team": {
                    "description": "The team code.",
                    "type": "string"
                  }
                },
                "required": [
                  "team",
                  "lineups"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "with_bring_back": {
              "description": "Lineups with a bring-back, a player of the other team of the QB's game, with or without a stack.",
              "type": "integer"
            },
            "without_stack": {
              "description": "Lineups with no QB stack: no teammate of the QB, or a lineup the stack rule cannot read in full (an empty seat, an unknown team or game). The two cannot be told apart.",
              "type": "integer"
            }
          },
          "required": [
            "qb_plus_1",
            "qb_plus_2",
            "qb_plus_3_or_more",
            "without_stack",
            "with_bring_back",
            "distinct_qbs",
            "stack_teams",
            "bring_back_teams"
          ],
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "lineups",
        "dispersion"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "contest": {
      "description": "The contest.",
      "properties": {
        "contest_id": {
          "description": "Internal contest ID.",
          "format": "int64",
          "type": "integer"
        },
        "date": {
          "description": "Contest date (YYYY-MM-DD).",
          "type": [
            "string",
            "null"
          ]
        },
        "entry_fee_cents": {
          "description": "Entry fee in cents.",
          "format": "int64",
          "type": "integer"
        },
        "external_id": {
          "description": "Operator contest ID.",
          "format": "int64",
          "type": "integer"
        },
        "game_type": {
          "description": "Game type (classic or showdown). Null when the contest has no lineup file.",
          "type": [
            "string",
            "null"
          ]
        },
        "has_lineups": {
          "description": "False when the contest has no lineup file (the standings are empty).",
          "type": "boolean"
        },
        "is_sampled": {
          "description": "True when the lineup file holds a sample of the field.",
          "type": "boolean"
        },
        "live": {
          "description": "Present only while the lineups come from a live file: a DraftKings contest whose games still run, read at each game start, every minute for the next 30 minutes, then every 15 minutes until its final file is loaded at Completed. The seats of players whose games have not started are hidden, and no player points, payouts or ownership are served. Absent for a final file. Payouts, the field block and stacks are null.",
          "properties": {
            "kickoff_at": {
              "description": "The latest game start of the contest's slate that the live file covers (UTC, RFC 3339).",
              "type": "string"
            },
            "read_at": {
              "description": "When the live file was read from DraftKings (UTC, RFC 3339). Ranks and points are as of this time.",
              "type": "string"
            }
          },
          "required": [
            "read_at",
            "kickoff_at"
          ],
          "type": [
            "object",
            "null"
          ]
        },
        "name": {
          "description": "Contest name.",
          "type": "string"
        },
        "operator": {
          "description": "Operator name (DraftKings or FanDuel).",
          "type": [
            "string",
            "null"
          ]
        },
        "paid_places": {
          "description": "Paid places. Null when the contest has no lineup file.",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "prize_pool_cents": {
          "description": "Prize pool in cents.",
          "format": "int64",
          "type": "integer"
        },
        "slate_id": {
          "description": "Internal slate ID.",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "slate_name": {
          "description": "Slate name.",
          "type": [
            "string",
            "null"
          ]
        },
        "slots": {
          "description": "Roster slots in lineup order.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "sport": {
          "description": "Sport code.",
          "type": "string"
        },
        "stored_lineups": {
          "description": "Lineups stored in the lineup file (below total_entries in a sampled contest).",
          "format": "int64",
          "type": "integer"
        },
        "total_entries": {
          "description": "Entries in the contest.",
          "format": "int64",
          "type": "integer"
        }
      },
      "required": [
        "contest_id",
        "external_id",
        "name",
        "sport",
        "entry_fee_cents",
        "prize_pool_cents",
        "total_entries",
        "stored_lineups",
        "is_sampled",
        "slots",
        "has_lineups"
      ],
      "type": "object"
    },
    "exposure": {
      "description": "One row per player the user played: chalk first (field order), then most-used. Empty when locked. Without DFS access every non-chalk row is hidden (a label, no ID or value).",
      "items": {
        "properties": {
          "captain_lineups": {
            "description": "The user's lineups with this player in the captain or MVP slot. Null without such a slot.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "chalk": {
            "description": "True on a chalk player's row shown clear without DFS access. False with DFS access.",
            "type": "boolean"
          },
          "edge": {
            "description": "(exposure_pct - field_pct) / 100 x (fantasy_points - C): points per lineup gained (+) or lost (-) against the field. Null when field_pct or fantasy_points is null, and on a hidden row.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          },
          "edge_band": {
            "description": "A hidden row's edge as a band, sent only when at least 5 non-chalk pool players at the same position would show the same band at this row's exposure. Else null (and listed in hidden). Null on a clear row.",
            "enum": [
              "+1 or more",
              "0 to +1",
              "0 to −1",
              "−1 or less"
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "exposure_pct": {
            "description": "Share of the user's lineups with this player in percent.",
            "format": "double",
            "type": "number"
          },
          "fantasy_points": {
            "description": "Fantasy points. Null when nothing measured them, and on a hidden row.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          },
          "field_pct": {
            "description": "Share of the field's lineups with this player in percent. Null when nothing measured it, and on a hidden row.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          },
          "hidden": {
            "description": "The fields this row withholds. Empty on a clear row.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "label": {
            "description": "P1..Pn on a hidden row, numbered in this response's exposure order (it means nothing outside the response). Null on a clear row.",
            "type": [
              "string",
              "null"
            ]
          },
          "leverage": {
            "description": "exposure_pct minus field_pct in percentage points. Null when field_pct is null.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          },
          "lineups": {
            "description": "The user's lineups with this player in any slot.",
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "description": "Player name. Null on a hidden row.",
            "type": [
              "string",
              "null"
            ]
          },
          "player_id": {
            "description": "stat-api player ID. Null on a hidden row.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "pool_id": {
            "description": "The player's ID in this contest's player pool (the IDs in seats). Null on a hidden row.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "position": {
            "description": "Position (clear on a hidden row too). Null when the pool row has no real position.",
            "type": [
              "string",
              "null"
            ]
          },
          "salary": {
            "description": "Salary. Null when the operator price is unknown, and on a hidden row.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "team": {
            "description": "Team abbreviation. Null on a hidden row.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "chalk",
          "lineups",
          "exposure_pct",
          "hidden"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "field": {
      "description": "What the field did, the same for every caller (the chalk is common knowledge). Null when the contest has no lineup file, or no stored lineup measured the field's ownership, and while the contest is live (contest.live).",
      "properties": {
        "avg_points_per_slot": {
          "description": "C: the field's average points per roster slot = sum over the pool of (field_pct / 100 x fantasy_points), divided by roster_slots. A showdown player adds his flex share x base points and his captain share x captain points.",
          "format": "double",
          "type": "number"
        },
        "chalk": {
          "description": "The 3 most-owned pool players, field_pct descending (a tie goes to the lower pool_id).",
          "items": {
            "properties": {
              "fantasy_points": {
                "description": "Fantasy points. Null when nothing measured them.",
                "format": "double",
                "type": [
                  "number",
                  "null"
                ]
              },
              "field_pct": {
                "description": "Share of the field's lineups with this player in percent.",
                "format": "double",
                "type": "number"
              },
              "name": {
                "description": "Player name.",
                "type": "string"
              },
              "pool_id": {
                "description": "The player's ID in this contest's player pool.",
                "format": "int64",
                "type": "integer"
              },
              "position": {
                "description": "Position. Null when the pool row has no real position.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "salary": {
                "description": "Salary. Null when the operator price is unknown.",
                "format": "int64",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "team": {
                "description": "Team abbreviation.",
                "type": "string"
              }
            },
            "required": [
              "pool_id",
              "name",
              "team",
              "field_pct"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "field_avg_lineup": {
          "description": "C x roster_slots: the field's average lineup points implied by ownership.",
          "format": "double",
          "type": "number"
        },
        "players_owned": {
          "description": "Distinct pool players with a field share above 0 in any slot: the players the field actually used.",
          "type": "integer"
        },
        "pool_size": {
          "description": "Distinct players in the pool (a showdown player counts once).",
          "type": "integer"
        },
        "roster_slots": {
          "description": "Roster slots per lineup.",
          "type": "integer"
        }
      },
      "required": [
        "roster_slots",
        "pool_size",
        "players_owned",
        "avg_points_per_slot",
        "field_avg_lineup",
        "chalk"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "lineups": {
      "description": "Every lineup of the user in finishing order. Empty when locked.",
      "items": {
        "properties": {
          "bring_back_team": {
            "description": "The team (such as PHI) of the bring-back seats of this lineup: the other team of the QB's game. Set only when stack has a BB part. Null otherwise.",
            "type": [
              "string",
              "null"
            ]
          },
          "payout_cents": {
            "description": "Payout in cents. Null while the contest is live (contest.live).",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "points": {
            "description": "Lineup fantasy points.",
            "format": "double",
            "type": "number"
          },
          "rank": {
            "description": "Finishing rank.",
            "type": "integer"
          },
          "row": {
            "description": "Standings row of this lineup.",
            "type": "integer"
          },
          "salary_used": {
            "description": "Sum of the seats' salaries. Null without DFS access, and when a seat's price is unknown.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "stack": {
            "description": "The combo of this lineup: QB, then the QB's teammates as WR, TE, RB (a count in front when more than 1), then BB for the bring-backs, joined by /, as QB/WR/RB/BB. The same value as `stack` on the standings row with this `row`, null in the same cases: no stack and no bring-back, a seat whose position, team or game is unknown, hide mode, and every contest that is not a classic NFL contest. The lineups CSV ends with it.",
            "type": [
              "string",
              "null"
            ]
          },
          "stack_team": {
            "description": "The team (such as DAL) of the QB of this lineup, the team the stack belongs to. Set exactly when stack is set. Null otherwise.",
            "type": [
              "string",
              "null"
            ]
          },
          "total_ownership": {
            "description": "Sum of the seats' field_pct in percent (a captain seat counts its captain share), from the unrounded shares, rounded to 1 decimal. Null in hide mode (Free, off the flagships) and when nothing measured ownership.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "row",
          "rank",
          "points"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "seats": {
      "description": "One row per seat of each lineup (lineup_row joins lineups[].row). Empty when locked. Without DFS access a non-chalk seat carries its exposure row's label, its slot and position, and no ID or value.",
      "items": {
        "properties": {
          "chalk": {
            "description": "True on a chalk player's seat shown clear without DFS access. False with DFS access.",
            "type": "boolean"
          },
          "fantasy_points": {
            "description": "The slot's points. Null on a hidden seat.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          },
          "field_pct": {
            "description": "Field ownership for this slot in percent (captain ownership for a captain slot). Null on a hidden seat.",
            "format": "double",
            "type": [
              "number",
              "null"
            ]
          },
          "hidden": {
            "description": "The fields this seat withholds. Empty on a clear seat.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "label": {
            "description": "The P<n> of the seat's hidden exposure row. Null on a clear seat.",
            "type": [
              "string",
              "null"
            ]
          },
          "lineup_row": {
            "description": "Standings row of the lineup this seat belongs to (lineups[].row).",
            "type": "integer"
          },
          "name": {
            "description": "Player name. Null on a hidden seat.",
            "type": [
              "string",
              "null"
            ]
          },
          "player_id": {
            "description": "stat-api player ID. Null on a hidden seat.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "pool_id": {
            "description": "Player pool ID. Null for an empty seat and a hidden seat.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "position": {
            "description": "Position (clear on a hidden seat too).",
            "type": [
              "string",
              "null"
            ]
          },
          "salary": {
            "description": "The slot's price. Null on a hidden seat.",
            "format": "int64",
            "type": [
              "integer",
              "null"
            ]
          },
          "slot": {
            "description": "Roster slot.",
            "type": "string"
          },
          "slot_index": {
            "description": "0-based position of the seat in the lineup (the order of contest.slots).",
            "type": "integer"
          },
          "stack_role": {
            "description": "The seat's part in its lineup's stack: stack (the QB, and every teammate of his team except the defense, when he has at least one) or bring_back (a player of the opposing team from the QB's game, with or without a stack). Null on any other seat, on a defense, when the lineup's stack cannot be read in full, in hide mode, and on every contest that is not a classic NFL contest.",
            "enum": [
              "stack",
              "bring_back"
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "team": {
            "description": "Team abbreviation. Null on a hidden seat.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "lineup_row",
          "slot_index",
          "slot",
          "chalk",
          "hidden"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "user": {
      "description": "The entrant.",
      "properties": {
        "avg_points": {
          "description": "Mean lineup points over all the user's lineups. Null when locked.",
          "format": "double",
          "type": [
            "number",
            "null"
          ]
        },
        "best_rank": {
          "description": "The user's best rank.",
          "type": "integer"
        },
        "best_row": {
          "description": "Standings row of the user's best entry.",
          "type": "integer"
        },
        "cashed": {
          "description": "The user's entries that won money. Null when locked, and while the contest is live (contest.live).",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "chalk_exposure": {
          "description": "The user's exposure to each field.chalk player, in the same order, including 0% rows (a full fade). Empty when locked or when the field block is null.",
          "items": {
            "properties": {
              "edge": {
                "description": "Points per lineup gained (+) or lost (-) against the field. Null when the player's points are unknown.",
                "format": "double",
                "type": [
                  "number",
                  "null"
                ]
              },
              "exposure_pct": {
                "description": "Share of the user's lineups with this player in percent.",
                "format": "double",
                "type": "number"
              },
              "field_pct": {
                "description": "Share of the field's lineups with this player in percent.",
                "format": "double",
                "type": "number"
              },
              "leverage": {
                "description": "exposure_pct minus field_pct in percentage points (a full fade is -field_pct).",
                "format": "double",
                "type": "number"
              },
              "lineups": {
                "description": "The user's lineups with this player.",
                "format": "int64",
                "type": "integer"
              },
              "pool_id": {
                "description": "The chalk player's ID in this contest's player pool.",
                "format": "int64",
                "type": "integer"
              }
            },
            "required": [
              "pool_id",
              "lineups",
              "exposure_pct",
              "field_pct",
              "leverage"
            ],
            "type": "object"
          },
          "type": "array"
 

# --- truncated at 32 KB (33 KB total) ---
# Full source: https://artifacts.apis.io/stat-api-com/json-schema/stat-api-com-dfscontests-user-lineups-dfs-contest-user-lineups-response-schema.json