Search:
Game Publisher
Author Machine

getExpansions

Brings back an array of all of the expansions that were released for a particular machine which you identify by one of its IDs.

As usual, you can retrieve all of the machines by using the call to getAllMachines. You will note the response to that call contains two ID fields for each machine: machine_type_id and item_id. You only need to use one of them with the call to getExpansions - the results you receive will be identical whichever one you choose.

http://www.everygamegoing.com/api/v1/getExpansions/[id_type]/[id]

Both [id_type] and [id] are mandatory parameters and no results will be returned without both of them being specified correctly.

The following call, substituting 'machine_type_id' for [id_type] and '7' for [id] ("Give me all expansions for the Acorn Electron"):

http://www.everygamegoing.com/api/v1/getExpansions/machine_type_id/7/

will return a response containing an array similar to the following:

{
	"response":
	[
		{
			"item_id":1590,
			"show_title":"Acorn Plus 1 Interface",
			"item_short_description":"An expansion to the Acorn Electron providing a printer port.",
			"publisher_info":"Acorn Computers"
		},
		{
			"item_id":1591,
			"show_title":"Acorn Plus 3 Interface",
			"item_short_description":"A large L-shaped expansion which adds a 3.5\" disc drive to the Acorn Electron.",
			"publisher_info":"Acorn Computers"
		},

		...

		{
			"item_id":9372,
			"show_title":"Trackball",
			"item_short_description":"",
			"publisher_info":"Wigmore House"
		},
		{
			"item_id":1644,
			"show_title":"Sidewinder Joystick Interface",
			"item_short_description":"",
			"publisher_info":"Wizard"
		},
		{
			"item_id":9367,
			"show_title":"Sign Writer",
			"item_short_description":"",
			"publisher_info":"Wright"
		}
	]
}

 
The fields returned are all self-explanatory but a table explaining them is given below.

Key Human-readable Explanation Value Data Type Value Example
item_id Item ID Integer 1590
show_title Item Show Title String Acorn Plus 1 Interface
item_short_description Description String An expansion to the Acorn...
publisher_info Publisher String Acorn Computers

The response will be identical if you use the alternative:

http://www.everygamegoing.com/api/v1/getExpansions/item_id/68059/

Note: The value for item_short_description may be an empty string.

As you would expect, each expansion has its own Item ID. You may use the call to getItemByItemID to get fuller information on the item if you need it.