Calendar Endpoints


Use the following endpoints to get data from the calendar.

GET /calendar/active

Get a list of current calendar entries.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
No country Filter on a specific country &country=Sweden

Example

https://api.ifpapinball.com/v1/calendar/active?api_key=RNDOAMGNAJTGQWKQ&country=Sweden
{
   "calendar":[
      {
         "calendar_id":"6981",
         "tournament_id":"6616",
         "tournament_name":"Stockholm Pinball",
         "address1":"123 Main St",
         "address2":"",
         "city":"Stockholm",
         "state":"",
         "zipcode":"12632",
         "country":"Sweden",
         "website":"http:\/\/stockholmpinball.com\/",
         "euro_champ_flag":"N",
         "papa_circuit_flag":"N",
         "director_name":"Some person",
         "latitude":"59.3022",
         "longitude":"18.0149",
         "details":"System varies, but typically set-the-highscore qualifications and then top-8",
         "private_flag":"N",
         "start_date":"2014-08-22",
         "end_date":"2014-08-22"
      },
      {[ ... more ... ]}
      
    ]
}

GET /calendar/history

Get a list of past calendar entries.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
No country Filter on a specific country &country=Sweden

Example

https://api.ifpapinball.com/v1/calendar/history?api_key=RNDOAMGNAJTGQWKQ&country=Sweden
{
   "calendar":[
      {
         "calendar_id":"251",
         "tournament_id":"9571",
         "tournament_name":"Laholms Pinball",
         "address1":"",
         "address2":"",
         "city":"Stockholm",
         "state":"",
         "zipcode":"",
         "country":"Sweden",
         "website":"http:\/\/www.svenskaflippersallskapet.com\/forum.php?action=showt&t=17583&p=0#new",
         "euro_champ_flag":"N",
         "papa_circuit_flag":"N",
         "director_name":"Someone",
         "latitude":"60.1282",
         "longitude":"18.6435",
         "details":"",
         "private_flag":"Y",
         "start_date":"2014-08-07",
         "end_date":"2014-08-07"
      },
      {[ ... more ... ]}
   ]
}

GET /calendar/:id

Get data regarding a specific calendar entry.

Parameters

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

Example

https://api.ifpapinball.com/v1/calendar/123?api_key=RNDOAMGNAJTGQWKQ
{
   "calendar":[
      {
         "calendar_id":"251",
         "tournament_id":"9571",
         "tournament_name":"Laholms Pinball",
         "address1":"",
         "address2":"",
         "city":"Stockholm",
         "state":"",
         "zipcode":"",
         "country":"Sweden",
         "website":"http:\/\/www.svenskaflippersallskapet.com\/forum.php?action=showt&t=17583&p=0#new",
         "euro_champ_flag":"N",
         "papa_circuit_flag":"N",
         "director_name":"Someone",
         "latitude":"60.1282",
         "longitude":"18.6435",
         "details":"",
         "private_flag":"Y",
         "start_date":"2014-07-03",
         "end_date":"2014-07-03"
      }
   ]
}

GET /calendar/search

Search for specific calendar entries.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ
No address Find tournaments close to an address &address=123%20main%20st%chicago%il
No m Search within # miles. Used with address search. &m=50
No k Search within # kilometers. Used with address search. &k=50

Example

https://api.ifpapinball.com/v1/calendar/search?api_key=vj6rAG&address=111%20main%20st%20dr%20westerville%20oh%2043081&m=50
{
   "calendar":[
      {
         "calendar_id":"6886",
         "tournament_id":"1521",
         "tournament_name":"IFPA Pinball Project Fundraiser - Columbus",
         "address1":"1991 Riverside Drive",
         "address2":"",
         "city":"Columbus",
         "state":"OH",
         "zipcode":"43221",
         "country":"United States",
         "website":"https:\/\/www.facebook.com\/events\/1457583641149795\/",
         "euro_champ_flag":"N",
         "papa_circuit_flag":"N",
         "director_name":"Therese Edwards",
         "latitude":"39.9953",
         "longitude":"-83.0718",
         "details":"Who: All are welcome",
         "private_flag":"N",
         "distance":14,
         "start_date":"2014-07-13",
         "end_date":"2014-07-13"
      }
   ],
   "total_entries":1,
   "search_parameters":{
      "distance":"50",
      "distance_type":"m",
      "address":"111 main st westerville oh 43081"
   }
}