Player Endpoints


Use this enpoints to retrieve data about players.

GET /player/:id

Get information about a player.

Parameters

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

Example

https://api.ifpapinball.com/v1/player/6?api_key=RNDOAMGNAJTGQWKQ
{  
   "player":{  
      "player_id":"4",
      "first_name":"Josh",
      "last_name":"Sharpe",
      "city":"Palatine",
      "state":"IL",
      "country_code":"US",
      "country_name":"United States",
      "initials":"JLS",
      "age":34,
      "excluded_flag":"N",
      "ifpa_registered":"Y"
   },
   "player_stats":{  
      "current_wppr_rank":"18",
      "last_month_rank":"17",
      "last_year_rank":"16",
      "highest_rank":"2",
      "highest_rank_date":"2004-07-01",
      "current_wppr_value":"591.52",
      "wppr_points_all_time":"2893.79",
      "best_finish":"1",
      "best_finish_count":"39",
      "average_finish":"8",
      "average_finish_last_year":"11",
      "total_events_all_time":"230",
      "total_active_events":"92",
      "total_events_away":"6",
      "ratings_rank":"14",
      "ratings_value":"1869.77",
      "efficiency_rank":"58",
      "efficiency_value":42.78
   },
   "championshipSeries":[  
      {  
         "view_id":"90",
         "group_code":"KY",
         "group_name":"Kentucky",
         "rank":"2",
         "country_name":"US"
      },
      {  
         "view_id":"87",
         "group_code":"IL",
         "group_name":"Illinois",
         "rank":"6",
         "country_name":"US"
      },
      { ... more ... }   
   ]
}

GET /player/:id/results

Get tournament results for a player.

Parameters

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

Example

https://api.ifpapinball.com/v1/player/6/results?api_key=RNDOAMGNAJTGQWKQ
{
   {
   "player_id":12000,
   "results_count":1,
   "results":[
      {
         "tournament_name":"Stern Launch Party Tournament - Seattle",
         "tournament_id":"348",
         "country_code":"US",
         "periodic_flag":"Y",
         "wppr_state":"Active",
         "event":[
            {
               "event_name":"Main Tournament",
               "event_date":"2011-10-21",
               "event_id":"1",
               "position":"34",
               "original_points":"0.02",
               "current_points":"0.0100"
            }
         ]
      }
   ]
}

GET /player/:id/pvp

Get player comparisons for a specific player, at a high level. Note that this only brings back data if the player has played someone more than twice.

Parameters

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

Example

https://api.ifpapinball.com/v1/player/12001/pvp?api_key=RNDOAMGNAJTGQWKQ
{
   "player_id":12001,
   "total_competitors":114,
   "pvp":[
      {
         "player_id":"800",
         "first_name":"Kevin",
         "last_name":"Smith",
         "win_count":"2",
         "loss_count":"23",
         "tie_count":"0"
      },
      {
         "player_id":"910",
         "first_name":"Raymond",
         "last_name":"Jones",
         "win_count":"12",
         "loss_count":"21",
         "tie_count":"0"
      },
      { ... many many more ... }
	 ]
}
					

GET /player/search

Search for players by either name or email.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
Yes q Search for players by name &q=J%20Sharpe
No email Find a specific person by email &email=ifpapinball@gmail.com

Example

https://api.ifpapinball.com/v1/player/search?api_key=RNDOAMGNAJTGQWKQ&q=J%20Sharpe
{
   "query":"J Sharpe",
   "search":[
      {
         "player_id":"4",
         "first_name":"Josh",
         "last_name":"Sharpe",
         "country_code":"US",
         "country_name":"United States",
         "city":"Palatine",
         "state":"IL",
         "wppr_rank":"18"
      },
      {
         "player_id":"25488",
         "first_name":"Jamie",
         "last_name":"Sharpe",
         "country_code":"NZ",
         "country_name":"New Zealand",
         "city":"",
         "state":"",
         "wppr_rank":"5304"
      }
   ]
}

GET /player/country_directors

Get a list of country directors.

Parameters

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

Example

https://api.ifpapinball.com/v1/player/country_directors?api_key=RNDOAMGNAJTGQWKQ
{
   "query":"country_directors",
   "search":[
      {
         "player_id":"8933",
         "first_name":"Daniel",
         "last_name":"Robar",
         "country_code":"AU",
         "country_name":"Australia",
         "city":"",
         "state":"",
         "wppr_rank":"773"
      },
      {
         "player_id":"471",
         "first_name":"Peter",
         "last_name":"Schimek",
         "country_code":"AT",
         "country_name":"Austria",
         "city":"Vienna",
         "state":"",
         "wppr_rank":"1074"
      },
      { ... more ... }
    ]
}

GET /player/:id/history

Get ranking and rating history for a player.

Parameters

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

Example

https://api.ifpapinball.com/v1/player/50/history?api_key=RNDOAMGNAJTGQWKQ
{  
   "player":{  
      "player_id":"12410",
      "first_name":"Jonathan",
      "last_name":"Williams"
   },
   "rank_history":[  
      {  
         "rank_date":"2014-08-01",
         "rank_position":"3009",
         "wppr_points":"9.3325"
      },
      {  
         "rank_date":"2014-07-01",
         "rank_position":"2965",
         "wppr_points":"9.3325"
      },
      { ... more ... }
   ]
   "rating_history":[  
      {  
         "rating_date":"2014-04-21",
         "rating":"1253.1040"
      },
      {  
         "rating_date":"2014-03-30",
         "rating":"1254.0520"
      },
      { ... more ... }
    ]
}