Tournament Endpoints


Use this enpoints to retrieve data about tournaments.

GET /tournament/:id

Get information about a tournament.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/tournament/6?api_key=RNDOAMGNAJTGQWKQ
{
   "tournament":{
      "tournament_id":"6",
      "tournament_name":"MD Pinball Championship",
      "city":"Baltimore",
      "state":"MD",
      "country_name":"United States",
      "contact_name":"Some Dude",
      "website":"http:\/\/www.google.com",
      "events":[
         {
            "event_id":"1",
            "event_name":"Main Tournament",
            "event_date":"2007-04-28",
            "winner_player_id":"17",
            "winner_first_name":"Paul",
            "winner_last_name":"Madison"
         },
         {
            "event_id":"1",
            "event_name":"Main Tournament",
            "event_date":"2006-04-30",
            "winner_player_id":"17",
            "winner_first_name":"Paul",
            "winner_last_name":"Madison"
         },
         {
            "event_id":"1",
            "event_name":"Main Tournament",
            "event_date":"2005-04-29",
            "winner_player_id":"4",
            "winner_first_name":"Josh",
            "winner_last_name":"Sharpe"
         }
      ]
   }
}

GET /tournament/:id/results

Get results for a tournament.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
No event_id Results for a specific event. If no event is provided, one will be picked for you. &event_id=1
No tour_date Results from a specific tournament date. If no date is provided, the most recent tournament date is used. Format of date is YYYY-MM-DD. &tour_date=2014-01-01

Example

https://api.ifpapinball.com/v1/tournament/6/results?api_key=RNDOAMGNAQ&event_id=1&tour_date=2006-04-30
{
   "tournament_name":"MD Pinball Championship",
   "tournament_id":"6",
   "event_name":"Main Tournament",
   "event_date":"2006-04-30",
   "event_id":"1",
   "results":{
      "Results":[
         {
            "position":"1",
            "player_id":"17",
            "first_name":"Paul",
            "last_name":"Madison",
            "rank":"27",
            "wppr_value":"26.04"
         },
         {
            "position":"2",
            "player_id":"100",
            "first_name":"Jessie",
            "last_name":"Howard",
            "rank":"427",
            "wppr_value":"2.09"
         },
         {
            "position":"2",
            "player_id":"99",
            "first_name":"John",
            "last_name":"Ross",
            "rank":"415",
            "wppr_value":"2.09"
         }
      ]
   }
}

GET /tournament/list

Get a highlevel list of tournaments.

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
No start_pos Start a specific spot in the list. Default is 1. &start_pos=50
No count Number of records to return. Max is 250. &count=100

Example

https://api.ifpapinball.com/v1/tournament/list?api_key=RNDOAMGNAJTGQWKQ&start_pos=50&count=25
{
   "tournament":[
      {
         "tournament_id":"588",
         "tournament_name":"Gameworks Chicago Monthly Pinball Tournament",
         "event_name":"Main Tournament",
         "event_id":"1",
         "event_date":"2014-07-01",
         "winner_name":"Zach Sharpe",
         "winner_player_id":"9",
         "country_code":"US",
         "country_name":"United States",
         "player_count":"6"
      },
      {
         "tournament_id":"315",
         "tournament_name":"Pinball Gallery Monthly Tournament",
         "event_name":"Main Tournament",
         "event_id":"1",
         "event_date":"2014-07-01",
         "winner_name":"Ken Martin",
         "winner_player_id":"12406",
         "country_code":"US",
         "country_name":"United States",
         "player_count":"21"
      },
      { ... more ... }
   ],
   "Total_Results":"6729"
}

GET /tournament/search

Search for a tournament by name.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
Yes q Search for players by name &q=IFPA

Example

https://api.ifpapinball.com/v1/tournament/search?api_key=RNDOAMGNAJTGQWKQ&q=PAPA
{
   "search":"PAPA",
   "tournament":[
      {
         "tournament_id":"73",
         "tournament_name":"FSPA PAPA Flip-off Tournament",
         "country_code":"US",
         "country_name":"United States",
         "event_count":"3",
         "last_event_date":"2008-07-28"
      },
      {
         "tournament_id":"226",
         "tournament_name":"PAPA Atlanta Flipoff",
         "country_code":"US",
         "country_name":"United States",
         "event_count":"2",
         "last_event_date":"1994-12-14"
      },
      { ... more ... }
   ]
}