Positions
Positions v2.0
Summary
| Positions | |
| Resource | |
| Positions | A list of all positions for a sport. |
| HTTP Methods | |
| GET | Retrieve all the positions for a sport. |
| Example | |
| Retrieve Positions | |
| XML field definitions | |
| /positions | A container element for the list of positions. |
| /positions/ | A container element for the data on one position. |
| /positions/ | The abbreviation for the position. |
| /positions/ | The percentage of CBSSports.com leagues that use the position. |
| /positions/ | A brief description of the position. |
| /positions/ | The name of the position. |
| /positions/ | The name of the stats group to which the position belongs. |
GET
Retrieve all the positions for a sport.
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 Positions
Sample URL
http://api.cbssports.com/fantasy/positions?version=2.0
XML Response
<?xml version="1.0"?>
<result uriAlias="/positions" uri="/positions" statusCode="200" statusMessage="OK">
<body>
<positions>
<position>
<stats_group>Batting</stats_group>
<abbr>C</abbr>
<avg>100</avg>
<name>Catcher</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>1B</abbr>
<avg>100</avg>
<name>First Baseman</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>2B</abbr>
<avg>100</avg>
<name>Second Baseman</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>3B</abbr>
<avg>100</avg>
<name>Third Baseman</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>SS</abbr>
<avg>100</avg>
<name>Shortstop</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>LF</abbr>
<avg>Less than 5</avg>
<name>Left Fielder</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>CF</abbr>
<avg>Less than 5</avg>
<name>Center Fielder</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>RF</abbr>
<avg>Less than 5</avg>
<name>Right Fielder</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>OF</abbr>
<avg> 97</avg>
<name>Outfielder</name>
<description>LF + CF + RF</description>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>DH</abbr>
<avg> 53</avg>
<name>Designated Hitter</name>
<description/>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>U</abbr>
<avg> 57</avg>
<name>Utility</name>
<description>Any Non-Pitcher</description>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>MI</abbr>
<avg> 47</avg>
<name>Middle Infielder</name>
<description>2B + SS</description>
</position>
<position>
<stats_group>Batting</stats_group>
<abbr>CI</abbr>
<avg> 47</avg>
<name>Corner Infielder</name>
<description>1B + 3B</description>
</position>
<position>
<stats_group>Pitching</stats_group>
<abbr>SP</abbr>
<avg> 50</avg>
<name>Starting Pitcher</name>
<description/>
</position>
<position>
<stats_group>Pitching</stats_group>
<abbr>RP</abbr>
<avg> 50</avg>
<name>Relief Pitcher</name>
<description/>
</position>
<position>
<stats_group>Pitching</stats_group>
<abbr>P</abbr>
<avg> 50</avg>
<name>Pitcher</name>
<description>Starters & Relievers</description>
</position>
<position>
<stats_group>Pitching</stats_group>
<abbr>PS</abbr>
<avg>Less than 5</avg>
<name>Pitching Staff</name>
<description/>
</position>
</positions>
</body>
</result>JSON Response
{
"body" : {
"positions" : [
{
"stats_group" : "Batting",
"abbr" : "C",
"avg" : "100",
"name" : "Catcher",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "1B",
"avg" : "100",
"name" : "First Baseman",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "2B",
"avg" : "100",
"name" : "Second Baseman",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "3B",
"avg" : "100",
"name" : "Third Baseman",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "SS",
"avg" : "100",
"name" : "Shortstop",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "LF",
"avg" : "Less than 5",
"name" : "Left Fielder",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "CF",
"avg" : "Less than 5",
"name" : "Center Fielder",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "RF",
"avg" : "Less than 5",
"name" : "Right Fielder",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "OF",
"avg" : " 97",
"name" : "Outfielder",
"description" : "LF + CF + RF"
},
{
"stats_group" : "Batting",
"abbr" : "DH",
"avg" : " 53",
"name" : "Designated Hitter",
"description" : ""
},
{
"stats_group" : "Batting",
"abbr" : "U",
"avg" : " 57",
"name" : "Utility",
"description" : "Any Non-Pitcher"
},
{
"stats_group" : "Batting",
"abbr" : "MI",
"avg" : " 47",
"name" : "Middle Infielder",
"description" : "2B + SS"
},
{
"stats_group" : "Batting",
"abbr" : "CI",
"avg" : " 47",
"name" : "Corner Infielder",
"description" : "1B + 3B"
},
{
"stats_group" : "Pitching",
"abbr" : "SP",
"avg" : " 50",
"name" : "Starting Pitcher",
"description" : ""
},
{
"stats_group" : "Pitching",
"abbr" : "RP",
"avg" : " 50",
"name" : "Relief Pitcher",
"description" : ""
},
{
"stats_group" : "Pitching",
"abbr" : "P",
"avg" : " 50",
"name" : "Pitcher",
"description" : "Starters & Relievers"
},
{
"stats_group" : "Pitching",
"abbr" : "PS",
"avg" : "Less than 5",
"name" : "Pitching Staff",
"description" : ""
}
]
},
"uriAlias" : "/positions",
"statusMessage" : "OK",
"uri" : "/positions",
"statusCode" : 200
}Sample URL
http://api.cbssports.com/fantasy/positions?version=2.0
XML Response
<?xml version="1.0"?>
<result uriAlias="/positions" uri="/positions" statusCode="200" statusMessage="OK">
<body>
<positions>
<position>
<stats_group>Offensive</stats_group>
<abbr>FLEX</abbr>
<avg>Less than 5</avg>
<name>Flex QB/RB/WR/TE</name>
<description/>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>ID</abbr>
<avg>Less than 5</avg>
<name>Defender</name>
<description>ID = DL + LB + DB</description>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>ST</abbr>
<avg>Less than 5</avg>
<name>Special Teams</name>
<description/>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>DL</abbr>
<avg>Less than 5</avg>
<name>Defensive Lineman</name>
<description>DL = DE + DT + NT</description>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>TE</abbr>
<avg>100</avg>
<name>Tight End</name>
<description/>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>K</abbr>
<avg>100</avg>
<name>Kicker</name>
<description/>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>WR-TE</abbr>
<avg>Less than 5</avg>
<name>Flex WR/TE</name>
<description/>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>LB</abbr>
<avg>Less than 5</avg>
<name>Linebacker</name>
<description>LB = MLB + OLB + ILB</description>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>DST</abbr>
<avg> 97</avg>
<name>Defense/ST</name>
<description>DST = Def Team + Spec Teams</description>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>RB-WR</abbr>
<avg> 7</avg>
<name>Flex RB/WR</name>
<description/>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>DB</abbr>
<avg>Less than 5</avg>
<name>Defensive Back</name>
<description>DB = CB + S</description>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>RB</abbr>
<avg>100</avg>
<name>Running Back</name>
<description/>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>RB-WR-TE</abbr>
<avg> 16</avg>
<name>Flex RB/WR/TE</name>
<description/>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>D</abbr>
<avg>Less than 5</avg>
<name>Defense</name>
<description/>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>QB</abbr>
<avg> 97</avg>
<name>Quarterback</name>
<description/>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>TQB</abbr>
<avg>Less than 5</avg>
<name>Team Quarterback</name>
<description>ALL QBs on same NFL team</description>
</position>
<position>
<stats_group>Defensive</stats_group>
<abbr>DL-LB-DB</abbr>
<avg>Less than 5</avg>
<name>Flex DL/LB/DB</name>
<description/>
</position>
<position>
<stats_group>Offensive</stats_group>
<abbr>WR</abbr>
<avg>100</avg>
<name>Wide Receiver</name>
<description/>
</position>
</positions>
</body>
</result>JSON Response
{
"body" : {
"positions" : [
{
"stats_group" : "Offensive",
"abbr" : "FLEX",
"avg" : "Less than 5",
"name" : "Flex QB/RB/WR/TE",
"description" : null
},
{
"stats_group" : "Defensive",
"abbr" : "ID",
"avg" : "Less than 5",
"name" : "Defender",
"description" : "ID = DL + LB + DB"
},
{
"stats_group" : "Defensive",
"abbr" : "ST",
"avg" : "Less than 5",
"name" : "Special Teams",
"description" : ""
},
{
"stats_group" : "Defensive",
"abbr" : "DL",
"avg" : "Less than 5",
"name" : "Defensive Lineman",
"description" : "DL = DE + DT + NT"
},
{
"stats_group" : "Offensive",
"abbr" : "TE",
"avg" : "100",
"name" : "Tight End",
"description" : ""
},
{
"stats_group" : "Offensive",
"abbr" : "K",
"avg" : "100",
"name" : "Kicker",
"description" : ""
},
{
"stats_group" : "Offensive",
"abbr" : "WR-TE",
"avg" : "Less than 5",
"name" : "Flex WR/TE",
"description" : null
},
{
"stats_group" : "Defensive",
"abbr" : "LB",
"avg" : "Less than 5",
"name" : "Linebacker",
"description" : "LB = MLB + OLB + ILB"
},
{
"stats_group" : "Defensive",
"abbr" : "DST",
"avg" : " 97",
"name" : "Defense/ST",
"description" : "DST = Def Team + Spec Teams"
},
{
"stats_group" : "Offensive",
"abbr" : "RB-WR",
"avg" : " 7",
"name" : "Flex RB/WR",
"description" : null
},
{
"stats_group" : "Defensive",
"abbr" : "DB",
"avg" : "Less than 5",
"name" : "Defensive Back",
"description" : "DB = CB + S"
},
{
"stats_group" : "Offensive",
"abbr" : "RB",
"avg" : "100",
"name" : "Running Back",
"description" : ""
},
{
"stats_group" : "Offensive",
"abbr" : "RB-WR-TE",
"avg" : " 16",
"name" : "Flex RB/WR/TE",
"description" : null
},
{
"stats_group" : "Defensive",
"abbr" : "D",
"avg" : "Less than 5",
"name" : "Defense",
"description" : ""
},
{
"stats_group" : "Offensive",
"abbr" : "QB",
"avg" : " 97",
"name" : "Quarterback",
"description" : ""
},
{
"stats_group" : "Offensive",
"abbr" : "TQB",
"avg" : "Less than 5",
"name" : "Team Quarterback",
"description" : "ALL QBs on same NFL team"
},
{
"stats_group" : "Defensive",
"abbr" : "DL-LB-DB",
"avg" : "Less than 5",
"name" : "Flex DL/LB/DB",
"description" : ""
},
{
"stats_group" : "Offensive",
"abbr" : "WR",
"avg" : "100",
"name" : "Wide Receiver",
"description" : ""
}
]
},
"uriAlias" : "/positions",
"statusMessage" : "OK",
"uri" : "/positions",
"statusCode" : 200
}/positions/position/stats_group
The name of the stats group to which the position belongs.
- For example, in baseball, the designated hitter and the shortstop positions both belong to the batting stats group. Possible values are Batting and Pitching.
- For example, in football, the Quarterback and Running Back positions both belong to the offensive stats group. Possible values are Offensive and Defensive.
