By-Period Standings v2.0
Summary
| By-Period Standings | |
| Resource | |
| By-Period Standings | Standings for a fantasy league for a specific period in ranked order. |
| Change Log | |
| January 15, 2013 | |
| HTTP Methods | |
| GET | Retrieve by-period standings. |
| Exceptions | |
| Following list of exceptions will be returned. | |
| Example | |
| Retrieve By-Period Standings for Period 1 | |
| XML field definitions | |
| /by_period_standings | A container element for the list of standings by period. |
| /by_period_standings/ | The fantasy game period to which the standings apply. |
| /by_period_standings/ | A container element for the list of teams whose standings are given for this period. |
| /by_period_standings/ | A container element for the data on a team. |
| /by_period_standings/ | The ID of the team. |
| /by_period_standings/ | A container element for the team’s total points. |
| /by_period_standings/ | The total number of points the team is behind the leader. |
| /by_period_standings/ | The total number of points for the team. |
| /by_period_standings/ | The total number of points for the team. |
| /by_period_standings/ | The difference between the team’s roto points in this period and the last period, as a positive or negative number. |
| /by_period_standings/ | The rank of the team in the current period. |
| /by_period_standings/ | An abbreviation of the team’s name, as a string with a maximum length of 10 characters. |
| /by_period_standings/ | An abbreviation of the team’s name, as a string with a maximum length of 6 characters. |
| /by_period_standings/ | A container element for the batting standings data for a team. |
| /by_period_standings/ | How far the team is behind the leader in batting points. |
| /by_period_standings/ | The number of batting points for the team in the specified period. |
| /by_period_standings/ | The number of batting points for the team in the specified period. |
| /by_period_standings/ | The difference between the team’s batting points in this period and the last period, as a positive or negative number. |
| /by_period_standings/ | A container element for the breakdown of the batting standings by category. |
| /by_period_standings/ | A container element for the breakdown of the batting standings in a category. |
| /by_period_standings/ | An abbreviation for the name of the category. |
| /by_period_standings/ | The points for the team in this category. |
| /by_period_standings/ | The points for the team in this category. |
| /by_period_standings/ | The actual value of the team’s statistics in this category. |
| /by_period_standings/ | The difference between the team’s points for the current category in this period and the last period, as a positive or negative number. |
| /by_period_standings/ | The team’s rank in this category. |
| /by_period_standings/ | The team’s rank in batting points. |
| /by_period_standings/ | The name of the team. |
| /by_period_standings/ | The URL of the team’s logo. |
| /by_period_standings/ | A container element for the pitching standings data for a team. |
| /by_period_standings/ | How far the team is behind the leader in pitching points. |
| /by_period_standings/ | The number of pitching points for the team in the specified period. |
| /by_period_standings/ | The number of pitching points for the team in the specified period. |
| /by_period_standings/ | The difference between the team’s pitching points in this period and the last period, as a positive or negative number. |
| /by_period_standings/ | A container element for the breakdown of the pitching standings by category. |
| /by_period_standings/ | A container element for the breakdown of the pitching standing in a category. |
| /by_period_standings/ | An abbreviation for the name of the category. |
| /by_period_standings/ | The points for the team in this category. |
| /by_period_standings/ | The points for the team in this category. |
| /by_period_standings/ | The actual value of the team’s statistics in this category. |
| /by_period_standings/ | The difference between the team’s points for the current category in this period and the last period, as a positive or negative number. |
| /by_period_standings/ | The team’s rank in this category. |
| /by_period_standings/ | The team’s rank in pitching points. |
| /by_period_standings/ | An abbreviation of the team’s name, as a string with a maximum length of 3 characters. |
By-Period Standings
Description
Standings for a fantasy league for a specific period in ranked order. Standings are not cumulative through a period, but for a specific period. By-period standings are only available for ranked and roto leagues. To determine the scoring system of the current league, request the Rules resource and examine the /rules/scoring_system/scoring_system field.
GET
Retrieve by-period standings.
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. |
| period | (optional) Period number for which standings are requested. Defaults to current period. |
Retrieve By-Period Standings for Period 1
Sample URL
http://api.cbssports.com/fantasy/league/standings/by-period?version=2.0&period=1
XML Response
By-Period Standings for a Roto League
<?xml version="1.0"?>
<result uriAlias="/league/standings/by-period" uri="/league/standings/by-period" statusCode="200" statusMessage="OK">
<body>
<by_period_standings>
<period>1</period>
<teams>
<team id="6">
<Total>
<behind>0</behind>
<roto_points>85.5</roto_points>
<diff>85.5</diff>
<rank>1</rank>
</Total>
<long_abbr>Team Long Abbreviation</long_abbr>
<short_name>Team Short Name</short_name>
<Batting>
<behind>1.5</behind>
<roto_points>45</roto_points>
<diff>45</diff>
<categories>
<category>
<abbr>HR</abbr>
<roto_points>9.5</roto_points>
<value>8</value>
<diff>9.5</diff>
<rank>3</rank>
</category>
<category>
<abbr>RBI</abbr>
<roto_points>4.5</roto_points>
<value>21</value>
<diff>4.5</diff>
<rank>8</rank>
</category>
<category>
<abbr>BA</abbr>
<roto_points>8</roto_points>
<value>0.2895</value>
<diff>8</diff>
<rank>5</rank>
</category>
<category>
<abbr>R</abbr>
<roto_points>12</roto_points>
<value>34</value>
<diff>12</diff>
<rank>1</rank>
</category>
<category>
<abbr>SB</abbr>
<roto_points>11</roto_points>
<value>4</value>
<diff>11</diff>
<rank>1</rank>
</category>
</categories>
<rank>2</rank>
</Batting>
<name>Team Name</name>
<logo>Team Logo URL</logo>
<Pitching>
<behind>4</behind>
<roto_points>40.5</roto_points>
<diff>40.5</diff>
<categories>
<category>
<abbr>S</abbr>
<roto_points>4.5</roto_points>
<value>1</value>
<diff>4.5</diff>
<rank>6</rank>
</category>
<category>
<abbr>W</abbr>
<roto_points>12</roto_points>
<value>5</value>
<diff>12</diff>
<rank>1</rank>
</category>
<category>
<abbr>K</abbr>
<roto_points>8.5</roto_points>
<value>34</value>
<diff>8.5</diff>
<rank>4</rank>
</category>
<category>
<abbr>ERA</abbr>
<roto_points>6</roto_points>
<value>4.413</value>
<diff>6</diff>
<rank>7</rank>
</category>
<category>
<abbr>WHIP</abbr>
<roto_points>9.5</roto_points>
<value>1.1250</value>
<diff>9.5</diff>
<rank>3</rank>
</category>
</categories>
<rank>2</rank>
</Pitching>
<abbr>Team Long Abbreviation</abbr>
</team>
<team id="2">
<Total>
<behind>3</behind>
<roto_points>82.5</roto_points>
<diff>82.5</diff>
<rank>2</rank>
</Total>
<long_abbr>Team Long Abbreviation</long_abbr>
<short_name>Team Short Name</short_name>
<Batting>
<behind>0</behind>
<roto_points>46.5</roto_points>
<diff>46.5</diff>
<categories>
<category>
<abbr>HR</abbr>
<roto_points>12</roto_points>
<value>10</value>
<diff>12</diff>
<rank>1</rank>
</category>
<category>
<abbr>RBI</abbr>
<roto_points>8</roto_points>
<value>23</value>
<diff>8</diff>
<rank>5</rank>
</category>
<category>
<abbr>BA</abbr>
<roto_points>9</roto_points>
<value>0.3046</value>
<diff>9</diff>
<rank>4</rank>
</category>
<category>
<abbr>R</abbr>
<roto_points>10.5</roto_points>
<value>29</value>
<diff>10.5</diff>
<rank>2</rank>
</category>
<category>
<abbr>SB</abbr>
<roto_points>7</roto_points>
<value>3</value>
<diff>7</diff>
<rank>4</rank>
</category>
</categories>
<rank>1</rank>
</Batting>
<name>Team Name</name>
<logo>Team Logo URL</logo>
<Pitching>
<behind>8.5</behind>
<roto_points>36</roto_points>
<diff>36</diff>
<categories>
<category>
<abbr>S</abbr>
<roto_points>8.5</roto_points>
<value>2</value>
<diff>8.5</diff>
<rank>4</rank>
</category>
<category>
<abbr>W</abbr>
<roto_points>8.5</roto_points>
<value>2</value>
<diff>8.5</diff>
<rank>4</rank>
</category>
<category>
<abbr>K</abbr>
<roto_points>4</roto_points>
<value>23</value>
<diff>4</diff>
<rank>9</rank>
</category>
<category>
<abbr>ERA</abbr>
<roto_points>8</roto_points>
<value>3.506</value>
<diff>8</diff>
<rank>5</rank>
</category>
<category>
<abbr>WHIP</abbr>
<roto_points>7</roto_points>
<value>1.2468</value>
<diff>7</diff>
<rank>6</rank>
</category>
</categories>
<rank>6</rank>
</Pitching>
<abbr>Team Long Abbreviation</abbr>
</team>
</teams>
</by_period_standings>
</body>
</result>By period standings for a ranked league.
<?xml version="1.0"?>
<result uriAlias="/league/standings/by-period" uri="/league/standings/by-period" statusCode="200" statusMessage="OK">
<body>
<by_period_standings>
<period>1</period>
<teams>
<team id="2">
<Total>
<behind>0</behind>
<diff>473.6667</diff>
<points>473.6667</points>
<rank>1</rank>
</Total>
<long_abbr>Team Long Abbreviation</long_abbr>
<short_name>Team Short Name</short_name>
<Batting>
<points>261</points>
<categories>
<category>
<abbr>BB</abbr>
<value>38</value>
<diff>38</diff>
<points>38</points>
</category>
<category>
<abbr>HR</abbr>
<value>17</value>
<diff>34</diff>
<points>34</points>
</category>
<category>
<abbr>RBI</abbr>
<value>49</value>
<diff>49</diff>
<points>49</points>
</category>
<category>
<abbr>H</abbr>
<value>87</value>
<diff>87</diff>
<points>87</points>
</category>
<category>
<abbr>R</abbr>
<value>42</value>
<diff>42</diff>
<points>42</points>
</category>
<category>
<abbr>SB</abbr>
<value>4</value>
<diff>8</diff>
<points>8</points>
</category>
<category>
<abbr>HP</abbr>
<value>3</value>
<diff>3</diff>
<points>3</points>
</category>
</categories>
</Batting>
<name>Team Name</name>
<logo>Team Logo URL</logo>
<Pitching>
<points>212.666666666667</points>
<categories>
<category>
<abbr>S</abbr>
<value>8</value>
<diff>80</diff>
<points>80</points>
</category>
<category>
<abbr>K</abbr>
<value>45</value>
<diff>45</diff>
<points>45</points>
</category>
<category>
<abbr>W</abbr>
<value>3</value>
<diff>30</diff>
<points>30</points>
</category>
<category>
<abbr>INN</abbr>
<value>57.7</value>
<diff>57.6667</diff>
<points>57.6667</points>
</category>
</categories>
</Pitching>
<abbr>Team Long Abbreviation</abbr>
</team>
<team id="6">
<Total>
<behind>47</behind>
<diff>426.6667</diff>
<points>426.6667</points>
<rank>2</rank>
</Total>
<long_abbr>Team Long Abbreviation</long_abbr>
<short_name>Team Short Name</short_name>
<Batting>
<points>243</points>
<categories>
<category>
<abbr>BB</abbr>
<value>28</value>
<diff>28</diff>
<points>28</points>
</category>
<category>
<abbr>HR</abbr>
<value>10</value>
<diff>20</diff>
<points>20</points>
</category>
<category>
<abbr>RBI</abbr>
<value>44</value>
<diff>44</diff>
<points>44</points>
</category>
<category>
<abbr>H</abbr>
<value>94</value>
<diff>94</diff>
<points>94</points>
</category>
<category>
<abbr>R</abbr>
<value>43</value>
<diff>43</diff>
<points>43</points>
</category>
<category>
<abbr>SB</abbr>
<value>7</value>
<diff>14</diff>
<points>14</points>
</category>
</categories>
</Batting>
<name>Team Name</name>
<logo>Team Logo URL</logo>
<Pitching>
<points>183.666666666667</points>
<categories>
<category>
<abbr>S</abbr>
<value>5</value>
<diff>50</diff>
<points>50</points>
</category>
<category>
<abbr>K</abbr>
<value>53</value>
<diff>53</diff>
<points>53</points>
</category>
<category>
<abbr>W</abbr>
<value>3</value>
<diff>30</diff>
<points>30</points>
</category>
<category>
<abbr>INN</abbr>
<value>50.7</value>
<diff>50.6667</diff>
<points>50.6667</points>
</category>
</categories>
</Pitching>
<abbr>Team Long Abbreviation</abbr>
</team>
</teams>
</by_period_standings>
</body>
</result>JSON Response
By-Period standings for roto league.
{
"body" : {
"by_period_standings" : {
"period" : "1",
"teams" : [
{
"Total" : {
"behind" : 0,
"roto_points" : "85.5",
"diff" : "85.5",
"rank" : 1
},
"long_abbr" : "Team Long Abbreviation",
"short_name" : "Team Short Name",
"Batting" : {
"behind" : "1.5",
"roto_points" : "45",
"diff" : 45,
"categories" : [
{
"abbr" : "HR",
"roto_points" : "9.5",
"value" : 8,
"diff" : "9.5",
"rank" : 3
},
{
"abbr" : "RBI",
"roto_points" : "4.5",
"value" : 21,
"diff" : "4.5",
"rank" : 8
},
{
"abbr" : "BA",
"roto_points" : 8,
"value" : "0.2895",
"diff" : 8,
"rank" : 5
},
{
"abbr" : "R",
"roto_points" : 12,
"value" : 34,
"diff" : 12,
"rank" : 1
},
{
"abbr" : "SB",
"roto_points" : 11,
"value" : 4,
"diff" : 11,
"rank" : 1
}
],
"rank" : 2
},
"name" : "Team Name",
"logo" : "Team Logo URL",
"Pitching" : {
"behind" : 4,
"roto_points" : "40.5",
"diff" : "40.5",
"categories" : [
{
"abbr" : "S",
"roto_points" : "4.5",
"value" : 1,
"diff" : "4.5",
"rank" : 6
},
{
"abbr" : "W",
"roto_points" : 12,
"value" : 5,
"diff" : 12,
"rank" : 1
},
{
"abbr" : "K",
"roto_points" : "8.5",
"value" : 34,
"diff" : "8.5",
"rank" : 4
},
{
"abbr" : "ERA",
"roto_points" : 6,
"value" : "4.413",
"diff" : 6,
"rank" : 7
},
{
"abbr" : "WHIP",
"roto_points" : "9.5",
"value" : "1.1250",
"diff" : "9.5",
"rank" : 3
}
],
"rank" : 2
},
"abbr" : "Team Long Abbreviation",
"id" : "6"
},
{
"Total" : {
"behind" : "49.5",
"roto_points" : "36",
"diff" : 36,
"rank" : 12
},
"long_abbr" : "Team Long Abbreviation",
"short_name" : "Team Short Name",
"Batting" : {
"behind" : 31,
"roto_points" : "15.5",
"diff" : "15.5",
"categories" : [
{
"abbr" : "HR",
"roto_points" : "1.5",
"value" : 2,
"diff" : "1.5",
"rank" : 11
},
{
"abbr" : "RBI",
"roto_points" : 1,
"value" : 12,
"diff" : 1,
"rank" : 12
},
{
"abbr" : "BA",
"roto_points" : 1,
"value" : "0.2160",
"diff" : 1,
"rank" : 12
},
{
"abbr" : "R",
"roto_points" : 5,
"value" : 22,
"diff" : 5,
"rank" : 8
},
{
"abbr" : "SB",
"roto_points" : 7,
"value" : 3,
"diff" : 7,
"rank" : 4
}
],
"rank" : 12
},
"name" : "Team Name",
"logo" : "Team Logo URL",
"Pitching" : {
"behind" : 24,
"roto_points" : "20.5",
"diff" : "20.5",
"categories" : [
{
"abbr" : "S",
"roto_points" : "4.5",
"value" : 1,
"diff" : "4.5",
"rank" : 6
},
{
"abbr" : "W",
"roto_points" : 4,
"value" : 1,
"diff" : 4,
"rank" : 6
},
{
"abbr" : "K",
"roto_points" : 7,
"value" : 29,
"diff" : 7,
"rank" : 6
},
{
"abbr" : "ERA",
"roto_points" : 3,
"value" : "5.786",
"diff" : 3,
"rank" : 10
},
{
"abbr" : "WHIP",
"roto_points" : 2,
"value" : "1.5804",
"diff" : 2,
"rank" : 11
}
],
"rank" : 11
},
"abbr" : "Team Long Abbreviation",
"id" : "13"
}
]
}
},
"uriAlias" : "/league/standings/by-period",
"statusMessage" : "OK",
"uri" : "/league/standings/by-period",
"statusCode" : 200
}By-period standings for ranked leagues.
{
"body" : {
"by_period_standings" : {
"period" : "1",
"teams" : [
{
"Total" : {
"behind" : 0,
"diff" : "473.6667",
"points" : "473.6667",
"rank" : 1
},
"long_abbr" : "Team Long Abbreviation",
"short_name" : "Team Short Name",
"Batting" : {
"points" : "261",
"categories" : [
{
"abbr" : "BB",
"value" : 38,
"diff" : 38,
"points" : 38
},
{
"abbr" : "HR",
"value" : 17,
"diff" : 34,
"points" : 34
},
{
"abbr" : "RBI",
"value" : 49,
"diff" : 49,
"points" : 49
},
{
"abbr" : "H",
"value" : 87,
"diff" : 87,
"points" : 87
},
{
"abbr" : "R",
"value" : 42,
"diff" : 42,
"points" : 42
},
{
"abbr" : "SB",
"value" : 4,
"diff" : 8,
"points" : 8
},
{
"abbr" : "HP",
"value" : 3,
"diff" : 3,
"points" : 3
}
]
},
"name" : "Team Name",
"logo" : "Team Logo URL",
"Pitching" : {
"points" : "212.666666666667",
"categories" : [
{
"abbr" : "S",
"value" : 8,
"diff" : 80,
"points" : 80
},
{
"abbr" : "K",
"value" : 45,
"diff" : 45,
"points" : 45
},
{
"abbr" : "W",
"value" : 3,
"diff" : 30,
"points" : 30
},
{
"abbr" : "INN",
"value" : "57.7",
"diff" : "57.6667",
"points" : "57.6667"
}
]
},
"abbr" : "Team Long Abbreviation",
"id" : "2"
},
{
"Total" : {
"behind" : "117.6667",
"diff" : "356",
"points" : "356.0000",
"rank" : 10
},
"long_abbr" : "Team Long Abbreviation",
"short_name" : "Team Short Name",
"Batting" : {
"points" : "202",
"categories" : [
{
"abbr" : "BB",
"value" : 28,
"diff" : 28,
"points" : 28
},
{
"abbr" : "HR",
"value" : 13,
"diff" : 26,
"points" : 26
},
{
"abbr" : "RBI",
"value" : 40,
"diff" : 40,
"points" : 40
},
{
"abbr" : "H",
"value" : 55,
"diff" : 55,
"points" : 55
},
{
"abbr" : "R",
"value" : 41,
"diff" : 41,
"points" : 41
},
{
"abbr" : "SB",
"value" : 5,
"diff" : 10,
"points" : 10
},
{
"abbr" : "HP",
"value" : 2,
"diff" : 2,
"points" : 2
}
]
},
"name" : "Team Name",
"logo" : "Team Logo URL",
"Pitching" : {
"points" : "154",
"categories" : [
{
"abbr" : "S",
"value" : 5,
"diff" : 50,
"points" : 50
},
{
"abbr" : "K",
"value" : 39,
"diff" : 39,
"points" : 39
},
{
"abbr" : "W",
"value" : 1,
"diff" : 10,
"points" : 10
},
{
"abbr" : "INN",
"value" : "55.0",
"diff" : 55,
"points" : 55
}
]
},
"abbr" : "Team Long Abbreviation",
"id" : "12"
}
]
}
},
"uriAlias" : "/league/standings/by-period",
"statusMessage" : "OK",
"uri" : "/league/standings/by-period",
"statusCode" : 200
}/by_period_standings/teams/team/@id
The ID of the team. To get a list of fantasy team IDs, request the Fantasy Teams resource.
/by_period_standings/teams/team/Batting/categories/category/abbr
An abbreviation for the name of the category. You can get a list of statistical categories by requesting the Stats Categories resource.
/by_period_standings/teams/team/Pitching/categories/category/abbr
An abbreviation for the name of the category. You can get a list of statistical categories by requesting the Stats Categories resource.
Specifies the scoring system, as a string.
