API | Games

Contains functionality to access game details, retrieves a paged list of games by a division, team, or date, and updating game details.

Game Details

Retrieves a game details.

Endpoint

GET https://soccer.exposureevents.com/api/v1/games

Parameters

Name Type Default Required Description
id integer The game id.
includes enumeration Additional data to be included in the response. Values should be separated by commas.
{
  "Game": {
    "Id": 64,
    "Type": 1,
    "Date": "12/18/2024",
    "Time": "3:25 PM",
    "Division": {
      "Id": 120,
      "Name": "17",
      "Event": {
        "Id": 30,
        "Name": "Exposure Soccer Events"
      }
    },
    "VenueCourt": {
      "Id": 0,
      "Court": {
        "Name": "Main",
        "Abbr": "MN"
      },
      "Venue": {
        "Id": 68,
        "Name": "Exposure High School",
        "Abbr": "EHS",
        "Address": {
          "Location": "Exposure High School",
          "StreetAddress": "3934 E Battala Avenue",
          "ExtendedAddress": "Suite 144",
          "City": "Gilbert",
          "StateRegion": "Arizona",
          "PostalCode": "85297",
          "Latitude": 36.1849073,
          "Longitude": -115.1230314
        }
      }
    },
    "AwayTeam": {
      "Name": "Away Team",
      "Pool": "A",
      "PoolNumber": 1,
      "Score": 57.0,
      "TeamId": 1487,
      "TeamPoolId": 55555,
      "BracketName": "Gold",
      "BracketId": 100,
      "DivisionSeed": 4,
      "Seed": 2,
      "DivisionId": 100,
      "DivisionName": "16",
      "WonBy": 7,
      "Color": "000000"
    },
    "HomeTeam": {
      "Name": "Home Team",
      "Pool": "A",
      "PoolNumber": 2,
      "Score": 58.0,
      "TeamId": 1488,
      "TeamPoolId": 45464,
      "PoolSeed": 2,
      "Exhibition": true,
      "Color": "FF0000"
    },
    "BracketName": "Championship",
    "Round": 2
  }
}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Game>
    <AwayTeam>
      <BracketId>100</BracketId>
      <BracketName>Gold</BracketName>
      <Color>000000</Color>
      <DivisionId>100</DivisionId>
      <DivisionName>16</DivisionName>
      <DivisionSeed>4</DivisionSeed>
      <Name>Away Team</Name>
      <Pool>A</Pool>
      <PoolNumber>1</PoolNumber>
      <Score>57</Score>
      <Seed>2</Seed>
      <TeamId>1487</TeamId>
      <TeamPoolId>55555</TeamPoolId>
      <WonBy>Forfeit</WonBy>
    </AwayTeam>
    <BracketName>Championship</BracketName>
    <Date>12/18/2024</Date>
    <Division>
      <Event>
        <Id>30</Id>
        <Name>Exposure Soccer Events</Name>
      </Event>
      <Id>120</Id>
      <Name>17</Name>
    </Division>
    <HomeTeam>
      <Color>FF0000</Color>
      <Exhibition>true</Exhibition>
      <Name>Home Team</Name>
      <Pool>A</Pool>
      <PoolNumber>2</PoolNumber>
      <PoolSeed>2</PoolSeed>
      <Score>58</Score>
      <TeamId>1488</TeamId>
      <TeamPoolId>45464</TeamPoolId>
    </HomeTeam>
    <Id>64</Id>
    <Round>2</Round>
    <Time>3:25 PM</Time>
    <Type>1</Type>
    <VenueCourt>
      <Court>
        <Abbr>MN</Abbr>
        <Name>Main</Name>
      </Court>
      <Id>0</Id>
      <Venue>
        <Abbr>EHS</Abbr>
        <Address>
          <City>Gilbert</City>
          <ExtendedAddress>Suite 144</ExtendedAddress>
          <Latitude>36.1849073</Latitude>
          <Location>Exposure High School</Location>
          <Longitude>-115.1230314</Longitude>
          <PostalCode>85297</PostalCode>
          <StateRegion>Arizona</StateRegion>
          <StreetAddress>3934 E Battala Avenue</StreetAddress>
        </Address>
        <Id>68</Id>
        <Name>Exposure High School</Name>
      </Venue>
    </VenueCourt>
  </Game>
</Response>

Games

Retrieves a paged list of games.

Endpoint

GET https://soccer.exposureevents.com/api/v1/games

Parameters

Name Type Default Required Description
page integer 1
pagesize integer 50
eventid integer The event id.
divisionid integer The division id.
teamid integer The team id.
date date The date of the games. The value must be in the format m/d/yyyy.
includes enumeration Additional data to be included in the response. Values should be separated by commas.
{
  "Games": {
    "Results": [
      {
        "Id": 64,
        "Type": 1,
        "Date": "12/18/2024",
        "Time": "3:25 PM",
        "Division": {
          "Id": 120,
          "Name": "17",
          "Event": {
            "Id": 30,
            "Name": "Exposure Soccer Events"
          }
        },
        "VenueCourt": {
          "Id": 0,
          "Court": {
            "Name": "Main",
            "Abbr": "MN"
          },
          "Venue": {
            "Id": 68,
            "Name": "Exposure High School",
            "Abbr": "EHS",
            "Address": {
              "Location": "Exposure High School",
              "StreetAddress": "3934 E Battala Avenue",
              "ExtendedAddress": "Suite 144",
              "City": "Gilbert",
              "StateRegion": "Arizona",
              "PostalCode": "85297",
              "Latitude": 36.1849073,
              "Longitude": -115.1230314
            }
          }
        },
        "AwayTeam": {
          "Name": "Away Team",
          "Pool": "A",
          "PoolNumber": 1,
          "Score": 57.0,
          "TeamId": 1487,
          "TeamPoolId": 55555,
          "BracketName": "Gold",
          "BracketId": 100,
          "DivisionSeed": 4,
          "Seed": 2,
          "DivisionId": 100,
          "DivisionName": "16",
          "WonBy": 7,
          "Color": "000000"
        },
        "HomeTeam": {
          "Name": "Home Team",
          "Pool": "A",
          "PoolNumber": 2,
          "Score": 58.0,
          "TeamId": 1488,
          "TeamPoolId": 45464,
          "PoolSeed": 2,
          "Exhibition": true,
          "Color": "FF0000"
        },
        "BracketName": "Championship",
        "Round": 2
      }
    ],
    "Page": 1,
    "PageSize": 50,
    "Total": 1
  }
}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Games>
    <Page>1</Page>
    <PageSize>50</PageSize>
    <Results>
      <Game>
        <AwayTeam>
          <BracketId>100</BracketId>
          <BracketName>Gold</BracketName>
          <Color>000000</Color>
          <DivisionId>100</DivisionId>
          <DivisionName>16</DivisionName>
          <DivisionSeed>4</DivisionSeed>
          <Name>Away Team</Name>
          <Pool>A</Pool>
          <PoolNumber>1</PoolNumber>
          <Score>57</Score>
          <Seed>2</Seed>
          <TeamId>1487</TeamId>
          <TeamPoolId>55555</TeamPoolId>
          <WonBy>Forfeit</WonBy>
        </AwayTeam>
        <BracketName>Championship</BracketName>
        <Date>12/18/2024</Date>
        <Division>
          <Event>
            <Id>30</Id>
            <Name>Exposure Soccer Events</Name>
          </Event>
          <Id>120</Id>
          <Name>17</Name>
        </Division>
        <HomeTeam>
          <Color>FF0000</Color>
          <Exhibition>true</Exhibition>
          <Name>Home Team</Name>
          <Pool>A</Pool>
          <PoolNumber>2</PoolNumber>
          <PoolSeed>2</PoolSeed>
          <Score>58</Score>
          <TeamId>1488</TeamId>
          <TeamPoolId>45464</TeamPoolId>
        </HomeTeam>
        <Id>64</Id>
        <Round>2</Round>
        <Time>3:25 PM</Time>
        <Type>1</Type>
        <VenueCourt>
          <Court>
            <Abbr>MN</Abbr>
            <Name>Main</Name>
          </Court>
          <Id>0</Id>
          <Venue>
            <Abbr>EHS</Abbr>
            <Address>
              <City>Gilbert</City>
              <ExtendedAddress>Suite 144</ExtendedAddress>
              <Latitude>36.1849073</Latitude>
              <Location>Exposure High School</Location>
              <Longitude>-115.1230314</Longitude>
              <PostalCode>85297</PostalCode>
              <StateRegion>Arizona</StateRegion>
              <StreetAddress>3934 E Battala Avenue</StreetAddress>
            </Address>
            <Id>68</Id>
            <Name>Exposure High School</Name>
          </Venue>
        </VenueCourt>
      </Game>
    </Results>
    <Total>1</Total>
  </Games>
</Response>

Update Game

Updates an existing game.

Endpoint

PUT https://soccer.exposureevents.com/api/v1/games

Parameters

Name Type Default Required Description
id integer The game id.
awayteamscore integer The score of the away team.
hometeamscore integer The score of the home team.
awayteamwonby enumeration How the away team was declared the winner.
hometeamwonby enumeration How the home team was declared the winner.
externalid string External vendor game id used for statistics.
Updates will only occur on parameters provided in the request and will ignore updating the other parameters.
{
  "Id": 64,
  "AwayScore": "55",
  "HomeScore": "56",
  "AwayTeamScore": "55",
  "HomeTeamScore": "56",
  "ExternalId": "4545420",
  "AwayWonBy": 7,
  "AwayTeamWonBy": 7
}
<Request xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <AwayColor i:nil="true" />
  <AwayScore>55</AwayScore>
  <AwayTeamScore>55</AwayTeamScore>
  <AwayTeamWonBy>Forfeit</AwayTeamWonBy>
  <AwayWonBy>Forfeit</AwayWonBy>
  <ExternalId>4545420</ExternalId>
  <HomeColor i:nil="true" />
  <HomeScore>56</HomeScore>
  <HomeTeamScore>56</HomeTeamScore>
  <HomeTeamWonBy i:nil="true" />
  <HomeWonBy i:nil="true" />
  <Id>64</Id>
  <Time i:nil="true" />
</Request>
{}
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
SOCCER EVENT, TOURNAMENT AND LEAGUE MARKETING Market your event now! Submit Event