Scoring Rules
Scoring Rules
Summary
| Scoring Rules | |
| Resource | |
| Scoring Rules | A list of stats categories a fantasy league uses in it’s scoring system. |
| HTTP Methods | |
| GET | Retrieve Scoring Rules for a league |
| Example | |
| Retrieve Scoring Rules for a league | |
| XML field definitions | |
| /scoring_rules | Container element for the scoring rules. |
| /scoring_rules/ | Container element for the list of categories. |
| /scoring_rules/ | Container element for the elements that specifiy the points assigned for each scoring category. |
| /scoring_rules/ | The container element for the list of bonuses assigned to a scoring category. |
| /scoring_rules/ | The group that the category belongs to. |
| /scoring_rules/ | The name of the scoring category, as an abbreviation. |
| /scoring_rules/ | The number of points assigned to this scoring category for a points based (h2h or ranked) scoring system OR the weight assigned to this category for a roto scoring system. |
| /scoring_rules/ | The container element for a list of scoring ranges for a scoring category. |
| /scoring_rules/ | The ID of the league. |
| /scoring_rules/ | The name of the league. |
| /scoring_rules/ | A boolean that specifies whether the league uses different scoring system for different positions. |
| /scoring_rules/ | Container element for position-specific scoring rules (will only be present for leagues that score differently by position). |
| /scoring_rules/ | |
| /scoring_rules/ | The container element for a scoring range. |
| /scoring_rules/ | The minimum end of the range. |
| /scoring_rules/ | The ‘for every’ value in a range. |
| /scoring_rules/ | The number of points awarded for this scoring range if no {per} value is specified. |
| /scoring_rules/ | The maximum end of the range. |
| /scoring_rules/ | The container element for a bonus assigned to a scoring category. |
| /scoring_rules/ | The minimum threshold a player must meet to receive the bonus. |
| /scoring_rules/ | The number of bonus points assigned to this scoring category. |
| /scoring_rules/ | The only possible value is +. |
| /scoring_rules/ | The only possible value is 1 and will only appear |
| /scoring_rules/ | Container element for a position-specific scoring category. |
| /scoring_rules/ | The container element for the list of bonuses assigned to a position-specific scoring category. |
| /scoring_rules/ | The group that the position belongs to. |
| /scoring_rules/ | The name of the scoring category, as an abbreviation. |
| /scoring_rules/ | The point value awarded for a position-specific scoring category. |
| /scoring_rules/ | The position that the scoring rule applies for. |
| /scoring_rules/ | The container element for a list of scoring ranges for a position-specific scoring category. |
GET
Retrieve Scoring Rules for a league
URL
http://api.cbssports.com
Parameters
| response_format | (optional) Specifies the format in which the requested resource should be returned. Valid values are XML and JSON. The default is XML. |
Retrieve Scoring Rules for a league
Sample URL
http://api.cbssports.com/fantasy/league/scoring/rules
XML Response
<?xml version="1.0"?>
<result uriAlias="/league/scoring/rules" uri="/league/scoring/rules" statusCode="200" statusMessage="OK">
<body>
<scoring_rules>
<system>h2h</system>
<positions/>
<categories>
<category>
<group>Batting</group>
<points>1</points>
<bonuses/>
<name>1B</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>-0.5</points>
<bonuses/>
<name>KO</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>1</points>
<bonuses/>
<name>BB</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>2</points>
<bonuses/>
<name>2B</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>4</points>
<bonuses/>
<name>HR</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>-1</points>
<bonuses/>
<name>CS</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>1</points>
<bonuses/>
<name>RBI</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>1</points>
<bonuses/>
<name>R</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>2</points>
<bonuses/>
<name>SB</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>1</points>
<bonuses/>
<name>HP</name>
<ranges/>
</category>
<category>
<group>Batting</group>
<points>3</points>
<bonuses/>
<name>3B</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>7</points>
<bonuses/>
<name>S</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>7</points>
<bonuses/>
<name>W</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>-1</points>
<bonuses/>
<name>HB</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>0.5</points>
<bonuses/>
<name>K</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>-1</points>
<bonuses/>
<name>HA</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>3</points>
<bonuses/>
<name>INN</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>-1</points>
<bonuses/>
<name>BBI</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>-1</points>
<bonuses/>
<name>ER</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>3</points>
<bonuses/>
<name>QS</name>
<ranges/>
</category>
<category>
<group>Pitching</group>
<points>-5</points>
<bonuses/>
<name>L</name>
<ranges/>
</category>
</categories>
<league_name>342-h2h-points</league_name>
<position_scoring>0</position_scoring>
<league_id>342-h2h-points</league_id>
</scoring_rules>
</body>
</result>JSON Response
{
"body" : {
"scoring_rules" : {
"system" : "h2h",
"positions" : [],
"categories" : [
{
"group" : "Batting",
"points" : 1,
"bonuses" : [],
"name" : "1B",
"ranges" : []
},
{
"group" : "Batting",
"points" : "-0.5",
"bonuses" : [],
"name" : "KO",
"ranges" : []
},
{
"group" : "Batting",
"points" : 1,
"bonuses" : [],
"name" : "BB",
"ranges" : []
},
{
"group" : "Batting",
"points" : 2,
"bonuses" : [],
"name" : "2B",
"ranges" : []
},
{
"group" : "Batting",
"points" : 4,
"bonuses" : [],
"name" : "HR",
"ranges" : []
},
{
"group" : "Batting",
"points" : -1,
"bonuses" : [],
"name" : "CS",
"ranges" : []
},
{
"group" : "Batting",
"points" : 1,
"bonuses" : [],
"name" : "RBI",
"ranges" : []
},
{
"group" : "Batting",
"points" : 1,
"bonuses" : [],
"name" : "R",
"ranges" : []
},
{
"group" : "Batting",
"points" : 2,
"bonuses" : [],
"name" : "SB",
"ranges" : []
},
{
"group" : "Batting",
"points" : 1,
"bonuses" : [],
"name" : "HP",
"ranges" : []
},
{
"group" : "Batting",
"points" : 3,
"bonuses" : [],
"name" : "3B",
"ranges" : []
},
{
"group" : "Pitching",
"points" : 7,
"bonuses" : [],
"name" : "S",
"ranges" : []
},
{
"group" : "Pitching",
"points" : 7,
"bonuses" : [],
"name" : "W",
"ranges" : []
},
{
"group" : "Pitching",
"points" : -1,
"bonuses" : [],
"name" : "HB",
"ranges" : []
},
{
"group" : "Pitching",
"points" : "0.5",
"bonuses" : [],
"name" : "K",
"ranges" : []
},
{
"group" : "Pitching",
"points" : -1,
"bonuses" : [],
"name" : "HA",
"ranges" : []
},
{
"group" : "Pitching",
"points" : 3,
"bonuses" : [],
"name" : "INN",
"ranges" : []
},
{
"group" : "Pitching",
"points" : -1,
"bonuses" : [],
"name" : "BBI",
"ranges" : []
},
{
"group" : "Pitching",
"points" : -1,
"bonuses" : [],
"name" : "ER",
"ranges" : []
},
{
"group" : "Pitching",
"points" : 3,
"bonuses" : [],
"name" : "QS",
"ranges" : []
},
{
"group" : "Pitching",
"points" : -5,
"bonuses" : [],
"name" : "L",
"ranges" : []
}
],
"league_name" : "342-h2h-points",
"position_scoring" : 0,
"league_id" : "342-h2h-points"
}
},
"uriAlias" : "/league/scoring/rules",
"statusMessage" : "OK",
"uri" : "/league/scoring/rules",
"statusCode" : 200
}Sample URL
http://api.cbssports.com/fantasy/league/scoring/rules
XML Response
<?xml version="1.0"?>
<result uriAlias="/league/scoring/rules" uri="/league/scoring/rules" statusCode="200" statusMessage="OK">
<body>
<scoring_rules>
<system>h2h</system>
<positions>
<position>
<group>Offensive</group>
<points>1</points>
<bonuses/>
<name>Recpt</name>
<pos>TE</pos>
<ranges/>
</position>
</positions>
<categories>
<category>
<group>Offensive</group>
<bonuses/>
<name>ReYd</name>
<ranges>
<range>
<to>+</to>
<from>0</from>
<points>.2</points>
<per>2</per>
</range>
</ranges>
</category>
<category>
<group>Offensive</group>
<points>-2</points>
<bonuses/>
<name>PaInt</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>-1</points>
<bonuses/>
<name>MXP</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>2</points>
<bonuses/>
<name>Ru2P</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>2</points>
<bonuses/>
<name>Re2P</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>3</points>
<bonuses>
<bonus>
<to>49</to>
<scale_bonus>1</scale_bonus>
<from>40</from>
<points>2</points>
</bonus>
<bonus>
<to>59</to>
<scale_bonus>1</scale_bonus>
<from>50</from>
<points>4</points>
</bonus>
<bonus>
<to>+</to>
<scale_bonus>1</scale_bonus>
<from>60</from>
<points>6</points>
</bonus>
</bonuses>
<name>FG</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<bonuses/>
<name>RuYd</name>
<ranges>
<range>
<to>+</to>
<from>0</from>
<points>.2</points>
<per>2</per>
</range>
</ranges>
</category>
<category>
<group>Offensive</group>
<points>1</points>
<bonuses/>
<name>XP</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>-2</points>
<bonuses/>
<name>FL</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<bonuses/>
<name>PaYd</name>
<ranges>
<range>
<to>+</to>
<from>0</from>
<points>.2</points>
<per>5</per>
</range>
</ranges>
</category>
<category>
<group>Offensive</group>
<points>-1</points>
<bonuses>
<bonus>
<to>29</to>
<scale_bonus>1</scale_bonus>
<from>0</from>
<points>-1</points>
</bonus>
</bonuses>
<name>MFG</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>6</points>
<bonuses/>
<name>PaTD</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>2</points>
<bonuses/>
<name>Pa2P</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>6</points>
<bonuses/>
<name>RuTD</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<points>6</points>
<bonuses/>
<name>ReTD</name>
<ranges/>
</category>
<category>
<group>Offensive</group>
<bonuses/>
<name>Recpt</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<points>2</points>
<bonuses/>
<name>STY</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<points>2</points>
<bonuses/>
<name>DFR</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<points>2</points>
<bonuses/>
<name>BP</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<points>2</points>
<bonuses/>
<name>Int</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<bonuses/>
<name>DSTPA</name>
<ranges>
<range>
<to>2</to>
<from>0</from>
<points>9</points>
</range>
<range>
<to>6</to>
<from>3</from>
<points>8</points>
</range>
<range>
<to>9</to>
<from>7</from>
<points>7</points>
</range>
<range>
<to>13</to>
<from>10</from>
<points>6</points>
</range>
<range>
<to>16</to>
<from>14</from>
<points>5</points>
</range>
<range>
<to>20</to>
<from>17</from>
<points>4</points>
</range>
<range>
<to>23</to>
<from>21</from>
<points>3</points>
</range>
<range>
<to>27</to>
<from>24</from>
<points>2</points>
</range>
<range>
<to>30</to>
<from>28</from>
<points>1</points>
</range>
</ranges>
</category>
<category>
<group>Defensive</group>
<points>1</points>
<bonuses/>
<name>SACK</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<points>3</points>
<bonuses/>
<name>BFB</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<points>6</points>
<bonuses/>
<name>DTD</name>
<ranges/>
</category>
<category>
<group>Defensive</group>
<bonuses/>
<name>YDS</name>
<ranges>
<range>
<to>49</to>
<from>0</from>
<points>12</points>
</range>
<range>
<to>74</to>
<from>50</from>
<points>11</points>
</range>
<range>
<to>99</to>
<from>75</from>
<points>10</points>
</range>
<range>
<to>124</to>
<from>100</from>
<points>9</points>
</range>
<range>
<to>149</to>
<from>125</from>
<points>8</points>
</range>
<range>
<to>174</to>
<from>150</from>
<points>7</points>
</range>
<range>
<to>199</to>
<from>175</from>
<points>6</points>
</range>
<range>
<to>224</to>
<from>200</from>
<points>5</points>
</range>
<range>
<to>249</to>
<from>225</from>
<points>4</points>
</range>
<range>
<to>274</to>
<from>250</from>
<points>3</points>
</range>
<range>
<to>299</to>
<from>275</from>
<points>2</points>
</range>
<range>
<to>324</to>
<from>300</from>
<points>1</points>
</range>
</ranges>
</category>
</categories>
<league_name>League Name</league_name>
<position_scoring>1</position_scoring>
<league_id>342-h2h</league_id>
</scoring_rules>
</body>
</result>JSON Response
{
"body" : {
"scoring_rules" : {
"system" : "h2h",
"positions" : [
{
"group" : "Offensive",
"points" : "1",
"bonuses" : [],
"name" : "Recpt",
"pos" : "TE",
"ranges" : []
}
],
"categories" : [
{
"group" : "Offensive",
"bonuses" : [],
"name" : "ReYd",
"ranges" : [
{
"to" : "+",
"from" : "0",
"points" : ".2",
"per" : "2"
}
]
},
{
"group" : "Offensive",
"points" : "-2",
"bonuses" : [],
"name" : "PaInt",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "-1",
"bonuses" : [],
"name" : "MXP",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "2",
"bonuses" : [],
"name" : "Ru2P",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "2",
"bonuses" : [],
"name" : "Re2P",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "3",
"bonuses" : [
{
"to" : "49",
"scale_bonus" : "1",
"from" : "40",
"points" : "2"
},
{
"to" : "59",
"scale_bonus" : "1",
"from" : "50",
"points" : "4"
},
{
"to" : "+",
"scale_bonus" : "1",
"from" : "60",
"points" : "6"
}
],
"name" : "FG",
"ranges" : []
},
{
"group" : "Offensive",
"bonuses" : [],
"name" : "RuYd",
"ranges" : [
{
"to" : "+",
"from" : "0",
"points" : ".2",
"per" : "2"
}
]
},
{
"group" : "Offensive",
"points" : "1",
"bonuses" : [],
"name" : "XP",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "-2",
"bonuses" : [],
"name" : "FL",
"ranges" : []
},
{
"group" : "Offensive",
"bonuses" : [],
"name" : "PaYd",
"ranges" : [
{
"to" : "+",
"from" : "0",
"points" : ".2",
"per" : "5"
}
]
},
{
"group" : "Offensive",
"points" : "-1",
"bonuses" : [
{
"to" : "29",
"scale_bonus" : "1",
"from" : "0",
"points" : "-1"
}
],
"name" : "MFG",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "6",
"bonuses" : [],
"name" : "PaTD",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "2",
"bonuses" : [],
"name" : "Pa2P",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "6",
"bonuses" : [],
"name" : "RuTD",
"ranges" : []
},
{
"group" : "Offensive",
"points" : "6",
"bonuses" : [],
"name" : "ReTD",
"ranges" : []
},
{
"group" : "Offensive",
"bonuses" : [],
"name" : "Recpt",
"ranges" : []
},
{
"group" : "Defensive",
"points" : "2",
"bonuses" : [],
"name" : "STY",
"ranges" : []
},
{
"group" : "Defensive",
"points" : "2",
"bonuses" : [],
"name" : "DFR",
"ranges" : []
},
{
"group" : "Defensive",
"points" : "2",
"bonuses" : [],
"name" : "BP",
"ranges" : []
},
{
"group" : "Defensive",
"points" : "2",
"bonuses" : [],
"name" : "Int",
"ranges" : []
},
{
"group" : "Defensive",
"bonuses" : [],
"name" : "DSTPA",
"ranges" : [
{
"to" : "2",
"from" : "0",
"points" : "9"
},
{
"to" : "6",
"from" : "3",
"points" : "8"
},
{
"to" : "9",
"from" : "7",
"points" : "7"
},
{
"to" : "13",
"from" : "10",
"points" : "6"
},
{
"to" : "16",
"from" : "14",
"points" : "5"
},
{
"to" : "20",
"from" : "17",
"points" : "4"
},
{
"to" : "23",
"from" : "21",
"points" : "3"
},
{
"to" : "27",
"from" : "24",
"points" : "2"
},
{
"to" : "30",
"from" : "28",
"points" : "1"
}
]
},
{
"group" : "Defensive",
"points" : "1",
"bonuses" : [],
"name" : "SACK",
"ranges" : []
},
{
"group" : "Defensive",
"points" : "3",
"bonuses" : [],
"name" : "BFB",
"ranges" : []
},
{
"group" : "Defensive",
"points" : "6",
"bonuses" : [],
"name" : "DTD",
"ranges" : []
},
{
"group" : "Defensive",
"bonuses" : [],
"name" : "YDS",
"ranges" : [
{
"to" : "49",
"from" : "0",
"points" : "12"
},
{
"to" : "74",
"from" : "50",
"points" : "11"
},
{
"to" : "99",
"from" : "75",
"points" : "10"
},
{
"to" : "124",
"from" : "100",
"points" : "9"
},
{
"to" : "149",
"from" : "125",
"points" : "8"
},
{
"to" : "174",
"from" : "150",
"points" : "7"
},
{
"to" : "199",
"from" : "175",
"points" : "6"
},
{
"to" : "224",
"from" : "200",
"points" : "5"
},
{
"to" : "249",
"from" : "225",
"points" : "4"
},
{
"to" : "274",
"from" : "250",
"points" : "3"
},
{
"to" : "299",
"from" : "275",
"points" : "2"
},
{
"to" : "324",
"from" : "300",
"points" : "1"
}
]
}
],
"league_name" : "League Name",
"position_scoring" : 1,
"league_id" : "342-h2h"
}
},
"uriAlias" : "/league/scoring/rules",
"statusMessage" : "OK",
"uri" : "/league/scoring/rules",
"statusCode" : 200
}/scoring_rules/categories/category/name
The name of the scoring category, as an abbreviation. You can get a list of category abbreviations by requesting the Stats Categories resource.
/scoring_rules/categories/category/bonuses/bonus/points
The number of bonus points assigned to this scoring category. A league can decide to give bonus points for a category by awarding a certain number of points when the player reaches a certain value of a stat. For example, a league can award a bonus of 2 points if the player reaches 2 homeruns.
/scoring_rules/positions/position/name
The name of the scoring category, as an abbreviation. You can get a list of category abbreviations by requesting the Stats Categories resource.
/scoring_rules/positions/position/pos
The position that the scoring rule applies for. You can get a list of position abbreviations by reguestion the Positions resource.
