Finding an "AVAILABLE" SIM

This guide will walk you through how to find a SIM that is in an "AVAILABLE" state. In order to provision a Standard Service, you need to have a SIM that is "AVAILABLE" and not in any other state.

Performing a search

Searches are performed by applying a GET to the base path of a resource, and applying query parameters to refine your results.

See the Search SIMs section of the API spec for a complete reference.

To find an AVAILABLE SIM:

GET https://api-test.gamma.co.uk/mobile/v1/sims?status=AVAILABLE

This will return a list of SIM resources that are in the requested state:

[
	{
		"self": "http://api-test.gamma.co.uk/mobile/v1/sims/8944200121300000001",
		"id": "8944200121300000001",
		"channelPartnerId": 123,
		"status": "AVAILABLE",
		"startDate": "2020-00-01T00:00:00.00",
		"puk1": "00000000",
		"puk2": "00000001",
		"pin1": "0000",
		"pin2": "0001"
	},
	{
		"self": "http://api-test.gamma.co.uk/mobile/v1/sims/894420012130000002",
		"id": "894420012130000002"
		"channelPartnerId": 123,
		"status": "AVAILABLE",
		"startDate": "2020-00-01T00:00:00.00",
		"puk1": "00000000",
		"puk2": "00000001",
		"pin1": "0000",
		"pin2": "0001"
	}
]

The ID here will match with the ICCID of the physical SIMs that you will have been provided with.