API | Teams

Contains all the functionality to access team details, and retrieves a paged list of teams by an event, division, status, or paid.

Team Details

Retrieves a team's details including additional data related to the team.

Endpoint

GET https://basketball.exposureevents.com/api/v1/teams

Parameters

Name Type Default Required Description
Id integer The team id.
includes enumeration Additional data to be included in the response. Values should be separated by commas.
{
  "Team": {
    "Id": 1393,
    "Sport": 0,
    "ParentId": 1,
    "Name": "Indiana Elite",
    "Gender": 1,
    "Paid": false,
    "Status": 1,
    "Division": {
      "Id": 22,
      "Name": "17"
    },
    "Address": {
      "City": "Gilbert",
      "Latitude": 36.1849073,
      "Longitude": -115.1230314
    },
    "Players": [
      {
        "Id": 22,
        "ParentId": 1,
        "Number": 22,
        "FirstName": "Bob",
        "LastName": "Smith",
        "ExternalPlayerId": "XDLG234L",
        "Address": {
          "StreetAddress": "3934 E Battala Avenue",
          "ExtendedAddress": "Suite 144",
          "City": "Gilbert",
          "StateRegion": "Arizona",
          "PostalCode": "85297"
        },
        "Birthdate": "12/12/2024",
        "HomePhone": "555-555-5555",
        "MobilePhone": "555-555-5555",
        "Email": "noreply@exposureevents.com",
        "Meta": [
          {
            "Name": "T-Shirt Size",
            "Value": "XL"
          }
        ],
        "BirthYear": 2017,
        "Height": "6-6",
        "Weight": 200,
        "School": "New Albany High School",
        "GraduationYear": 2008,
        "Grade": "6th",
        "Position": "Guard",
        "TravelTeam": "Indiana Elite",
        "ACTScore": 36,
        "SATScore": 1600,
        "GPA": 4.0,
        "Active": true
      }
    ],
    "Coaches": [
      {
        "Id": 22,
        "Type": 2,
        "FirstName": "Bob",
        "LastName": "Smith",
        "Address": {
          "StreetAddress": "3934 E Battala Avenue",
          "ExtendedAddress": "Suite 144",
          "City": "Gilbert",
          "StateRegion": "Arizona",
          "PostalCode": "85297"
        },
        "HomePhone": "555-555-5555",
        "MobilePhone": "555-555-5555",
        "FaxPhone": "555-555-5555",
        "WorkPhone": "555-555-5555",
        "Email": "noreply@exposureevents.com",
        "ParentId": 1
      }
    ],
    "Pools": [
      {
        "Pool": {
          "Id": 100,
          "Name": "A",
          "Label": "Super Teams",
          "Division": {
            "Id": 22,
            "Name": "17"
          }
        },
        "Number": 1
      }
    ]
  }
}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Team>
    <Address>
      <City>Gilbert</City>
      <Latitude>36.1849073</Latitude>
      <Longitude>-115.1230314</Longitude>
    </Address>
    <Coaches>
      <Coach>
        <Address>
          <City>Gilbert</City>
          <ExtendedAddress>Suite 144</ExtendedAddress>
          <PostalCode>85297</PostalCode>
          <StateRegion>Arizona</StateRegion>
          <StreetAddress>3934 E Battala Avenue</StreetAddress>
        </Address>
        <Email>noreply@exposureevents.com</Email>
        <FaxPhone>555-555-5555</FaxPhone>
        <FirstName>Bob</FirstName>
        <HomePhone>555-555-5555</HomePhone>
        <Id>22</Id>
        <LastName>Smith</LastName>
        <MobilePhone>555-555-5555</MobilePhone>
        <ParentId>1</ParentId>
        <Type>2</Type>
        <WorkPhone>555-555-5555</WorkPhone>
      </Coach>
    </Coaches>
    <Division>
      <Id>22</Id>
      <Name>17</Name>
    </Division>
    <Gender>1</Gender>
    <Id>1393</Id>
    <Name>Indiana Elite</Name>
    <Paid>false</Paid>
    <ParentId>1</ParentId>
    <Players>
      <Player>
        <ACTScore>36</ACTScore>
        <Active>true</Active>
        <Address>
          <City>Gilbert</City>
          <ExtendedAddress>Suite 144</ExtendedAddress>
          <PostalCode>85297</PostalCode>
          <StateRegion>Arizona</StateRegion>
          <StreetAddress>3934 E Battala Avenue</StreetAddress>
        </Address>
        <BirthYear>2017</BirthYear>
        <Birthdate>12/12/2024</Birthdate>
        <Email>noreply@exposureevents.com</Email>
        <ExternalPlayerId>XDLG234L</ExternalPlayerId>
        <FirstName>Bob</FirstName>
        <GPA>4</GPA>
        <Grade>6th</Grade>
        <GraduationYear>2008</GraduationYear>
        <Height>6-6</Height>
        <HomePhone>555-555-5555</HomePhone>
        <Id>22</Id>
        <LastName>Smith</LastName>
        <Meta>
          <Meta>
            <Name>T-Shirt Size</Name>
            <Value>XL</Value>
          </Meta>
        </Meta>
        <MobilePhone>555-555-5555</MobilePhone>
        <Number>22</Number>
        <ParentId>1</ParentId>
        <Position>Guard</Position>
        <SATScore>1600</SATScore>
        <School>New Albany High School</School>
        <TravelTeam>Indiana Elite</TravelTeam>
        <Weight>200</Weight>
      </Player>
    </Players>
    <Pools>
      <TeamPool>
        <Number>1</Number>
        <Pool>
          <Division>
            <Id>22</Id>
            <Name>17</Name>
          </Division>
          <Id>100</Id>
          <Label>Super Teams</Label>
          <Name>A</Name>
        </Pool>
      </TeamPool>
    </Pools>
    <Sport>0</Sport>
    <Status>1</Status>
  </Team>
</Response>

Teams

Retrieves a paged list of teams.

Endpoint

GET https://basketball.exposureevents.com/api/v1/teams

Parameters

Name Type Default Required Description
page integer 1
pagesize integer 50
EventId integer The event id of the team (required if no division id).
DivisionId integer The division id of the team (required if no event id).
TeamIds array The ids of one or more teams.
Status enumeration The status of the team.
Paid boolean If supplied, show teams from event settings is ignored
includes enumeration Additional data to be included in the response. Values should be separated by commas.
{
  "Teams": {
    "Results": [
      {
        "Id": 1393,
        "Sport": 0,
        "ParentId": 1,
        "Name": "Indiana Elite",
        "Gender": 1,
        "Paid": false,
        "Status": 1,
        "Division": {
          "Id": 22,
          "Name": "17"
        },
        "Address": {
          "City": "Gilbert",
          "Latitude": 36.1849073,
          "Longitude": -115.1230314
        },
        "Players": [
          {
            "Id": 22,
            "ParentId": 1,
            "Number": 22,
            "FirstName": "Bob",
            "LastName": "Smith",
            "ExternalPlayerId": "XDLG234L",
            "Address": {
              "StreetAddress": "3934 E Battala Avenue",
              "ExtendedAddress": "Suite 144",
              "City": "Gilbert",
              "StateRegion": "Arizona",
              "PostalCode": "85297"
            },
            "Birthdate": "12/12/2024",
            "HomePhone": "555-555-5555",
            "MobilePhone": "555-555-5555",
            "Email": "noreply@exposureevents.com",
            "Meta": [
              {
                "Name": "T-Shirt Size",
                "Value": "XL"
              }
            ],
            "BirthYear": 2017,
            "Height": "6-6",
            "Weight": 200,
            "School": "New Albany High School",
            "GraduationYear": 2008,
            "Grade": "6th",
            "Position": "Guard",
            "TravelTeam": "Indiana Elite",
            "ACTScore": 36,
            "SATScore": 1600,
            "GPA": 4.0,
            "Active": true
          }
        ],
        "Coaches": [
          {
            "Id": 22,
            "Type": 2,
            "FirstName": "Bob",
            "LastName": "Smith",
            "Address": {
              "StreetAddress": "3934 E Battala Avenue",
              "ExtendedAddress": "Suite 144",
              "City": "Gilbert",
              "StateRegion": "Arizona",
              "PostalCode": "85297"
            },
            "HomePhone": "555-555-5555",
            "MobilePhone": "555-555-5555",
            "FaxPhone": "555-555-5555",
            "WorkPhone": "555-555-5555",
            "Email": "noreply@exposureevents.com",
            "ParentId": 1
          }
        ],
        "Pools": [
          {
            "Pool": {
              "Id": 100,
              "Name": "A",
              "Label": "Super Teams",
              "Division": {
                "Id": 22,
                "Name": "17"
              }
            },
            "Number": 1
          }
        ]
      }
    ],
    "Page": 1,
    "PageSize": 50,
    "Total": 1
  }
}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Teams>
    <Page>1</Page>
    <PageSize>50</PageSize>
    <Results>
      <Team>
        <Address>
          <City>Gilbert</City>
          <Latitude>36.1849073</Latitude>
          <Longitude>-115.1230314</Longitude>
        </Address>
        <Coaches>
          <Coach>
            <Address>
              <City>Gilbert</City>
              <ExtendedAddress>Suite 144</ExtendedAddress>
              <PostalCode>85297</PostalCode>
              <StateRegion>Arizona</StateRegion>
              <StreetAddress>3934 E Battala Avenue</StreetAddress>
            </Address>
            <Email>noreply@exposureevents.com</Email>
            <FaxPhone>555-555-5555</FaxPhone>
            <FirstName>Bob</FirstName>
            <HomePhone>555-555-5555</HomePhone>
            <Id>22</Id>
            <LastName>Smith</LastName>
            <MobilePhone>555-555-5555</MobilePhone>
            <ParentId>1</ParentId>
            <Type>2</Type>
            <WorkPhone>555-555-5555</WorkPhone>
          </Coach>
        </Coaches>
        <Division>
          <Id>22</Id>
          <Name>17</Name>
        </Division>
        <Gender>1</Gender>
        <Id>1393</Id>
        <Name>Indiana Elite</Name>
        <Paid>false</Paid>
        <ParentId>1</ParentId>
        <Players>
          <Player>
            <ACTScore>36</ACTScore>
            <Active>true</Active>
            <Address>
              <City>Gilbert</City>
              <ExtendedAddress>Suite 144</ExtendedAddress>
              <PostalCode>85297</PostalCode>
              <StateRegion>Arizona</StateRegion>
              <StreetAddress>3934 E Battala Avenue</StreetAddress>
            </Address>
            <BirthYear>2017</BirthYear>
            <Birthdate>12/12/2024</Birthdate>
            <Email>noreply@exposureevents.com</Email>
            <ExternalPlayerId>XDLG234L</ExternalPlayerId>
            <FirstName>Bob</FirstName>
            <GPA>4</GPA>
            <Grade>6th</Grade>
            <GraduationYear>2008</GraduationYear>
            <Height>6-6</Height>
            <HomePhone>555-555-5555</HomePhone>
            <Id>22</Id>
            <LastName>Smith</LastName>
            <Meta>
              <Meta>
                <Name>T-Shirt Size</Name>
                <Value>XL</Value>
              </Meta>
            </Meta>
            <MobilePhone>555-555-5555</MobilePhone>
            <Number>22</Number>
            <ParentId>1</ParentId>
            <Position>Guard</Position>
            <SATScore>1600</SATScore>
            <School>New Albany High School</School>
            <TravelTeam>Indiana Elite</TravelTeam>
            <Weight>200</Weight>
          </Player>
        </Players>
        <Pools>
          <TeamPool>
            <Number>1</Number>
            <Pool>
              <Division>
                <Id>22</Id>
                <Name>17</Name>
              </Division>
              <Id>100</Id>
              <Label>Super Teams</Label>
              <Name>A</Name>
            </Pool>
          </TeamPool>
        </Pools>
        <Sport>0</Sport>
        <Status>1</Status>
      </Team>
    </Results>
    <Total>1</Total>
  </Teams>
</Response>

Create Team

Creates a new division team.

Endpoint

POST https://basketball.exposureevents.com/api/v1/teams

Parameters

Name Type Default Required Description
eventid integer The event ID.
divisionid integer The division ID.
name string The name of the participant.
age enumeration The age of the participant.
grade enumeration The grade of the participant.
externalteamid string External team ID
gender enumeration The gender of the participant.
paid boolean true Marks the team as paid.
status enumeration The event status of the participant.
address.city string (100)
address.stateregion string (100)
address.postalcode string (10)
notes string Internal notes for a team.
website string The team website, must start with http://.
twitterhandle string The Twitter handle of the team, exclude @ sign.
abbreviation string
players array (20) An array of players for the team.
players.firstname string (100)
players.lastname string (100)
players.city string (100)
players.stateregion string (100)
players.postalcode string (10)
players.position string (100)
players.height string (100)
players.weight integer (3)
players.gradudationyear integer (4)
players.grade string (100)
players.school string (100)
players.number integer (3)
players.active boolean
{
  "DivisionId": 1000,
  "Name": "Team Exposure",
  "Gender": 2,
  "Paid": true,
  "Status": 1,
  "Address": {
    "City": "Louisville",
    "StateRegion": "KY",
    "PostalCode": "40205"
  },
  "Players": [
    {
      "ExternalPlayerId": "P1",
      "FirstName": "Anderson",
      "LastName": "Ginkins",
      "Number": "23"
    }
  ],
  "Notes": "Team needs a refund",
  "Website": "https://basketball.exposureevents.com",
  "TwitterHandle": "exposurebball",
  "Abbreviation": "TE",
  "ExternalTeamId": "45465gG",
  "InstagramHandle": "exposurebball",
  "FacebookPage": "http://facebook.com/exposurebball"
}
<Request xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Abbreviation>TE</Abbreviation>
  <Address>
    <City>Louisville</City>
    <PostalCode>40205</PostalCode>
    <StateRegion>KY</StateRegion>
  </Address>
  <DivisionId>1000</DivisionId>
  <ExternalTeamId>45465gG</ExternalTeamId>
  <FacebookPage>http://facebook.com/exposurebball</FacebookPage>
  <Gender>2</Gender>
  <InstagramHandle>exposurebball</InstagramHandle>
  <Name>Team Exposure</Name>
  <Notes>Team needs a refund</Notes>
  <Paid>true</Paid>
  <Players>
    <Player>
      <ExternalPlayerId>P1</ExternalPlayerId>
      <FirstName>Anderson</FirstName>
      <LastName>Ginkins</LastName>
      <Number>23</Number>
    </Player>
  </Players>
  <Status>1</Status>
  <TwitterHandle>exposurebball</TwitterHandle>
  <Website>https://basketball.exposureevents.com</Website>
</Request>
{
  "Id": 100
}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Id>100</Id>
</Response>

Update Team

Updates an existing division team.

Endpoint

PUT https://basketball.exposureevents.com/api/v1/teams

Parameters

Name Type Default Required Description
id integer The team ID. The external team ID can be used in place of this.
eventid integer The event ID.
divisionid integer The division ID.
name string The name of the participant.
age enumeration The age of the participant.
grade enumeration The grade of the participant.
externalteamid string External team ID
gender enumeration The gender of the participant.
paid boolean true Marks the team as paid.
status enumeration The event status of the participant.
address.city string (100)
address.stateregion string (100)
address.postalcode string (10)
notes string Internal notes for a team.
website string The team website, must start with http://.
twitterhandle string The Twitter handle of the team, exclude @ sign.
abbreviation string
players array (20) An array of players for the team.
players.firstname string (100)
players.lastname string (100)
players.city string (100)
players.stateregion string (100)
players.postalcode string (10)
players.position string (100)
players.height string (100)
players.weight integer (3)
players.gradudationyear integer (4)
players.grade string (100)
players.school string (100)
players.number integer (3)
players.active boolean
Updates will only occur on parameters provided in the request and will ignore updating the other parameters.
{
  "Id": 100,
  "DivisionId": 1000,
  "Name": "Team Exposure",
  "Gender": 2,
  "Paid": true,
  "Status": 1,
  "Address": {
    "City": "Louisville",
    "StateRegion": "KY",
    "PostalCode": "40205"
  },
  "Players": [
    {
      "Id": 100,
      "ExternalPlayerId": "P1",
      "FirstName": "Anderson",
      "LastName": "Ginkins",
      "Number": "23"
    }
  ],
  "Notes": "Team needs a refund",
  "Website": "https://basketball.exposureevents.com",
  "TwitterHandle": "exposurebball",
  "Abbreviation": "TE",
  "ExternalTeamId": "45465gG",
  "InstagramHandle": "exposurebball",
  "FacebookPage": "http://facebook.com/exposurebball"
}
<Request xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Abbreviation>TE</Abbreviation>
  <Address>
    <City>Louisville</City>
    <PostalCode>40205</PostalCode>
    <StateRegion>KY</StateRegion>
  </Address>
  <DivisionId>1000</DivisionId>
  <ExternalTeamId>45465gG</ExternalTeamId>
  <FacebookPage>http://facebook.com/exposurebball</FacebookPage>
  <Gender>2</Gender>
  <InstagramHandle>exposurebball</InstagramHandle>
  <Name>Team Exposure</Name>
  <Notes>Team needs a refund</Notes>
  <Paid>true</Paid>
  <Players>
    <Player>
      <ExternalPlayerId>P1</ExternalPlayerId>
      <FirstName>Anderson</FirstName>
      <Id>100</Id>
      <LastName>Ginkins</LastName>
      <Number>23</Number>
    </Player>
  </Players>
  <Status>1</Status>
  <TwitterHandle>exposurebball</TwitterHandle>
  <Website>https://basketball.exposureevents.com</Website>
  <Id>100</Id>
</Request>
{}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
BASKETBALL EVENT, TOURNAMENT AND LEAGUE MARKETING Market your event now! Submit Event