Fetches the mobile device details. For iOS, this will only ever be the device id. For other device types (Android, WindowsPhone, Windows8 and BlackBerry), the current "push" status is also included, indicating whether push communications may be sent to this device.

Endpoint ID:

4003

Method:

GET

URL:

/mobile/device/registration/entity/id/{entity-id}/{device-id}

/mobile/device/registration/entity/ext-key/{ext-key}/{ext-type}/{device-id}

entity-id

Rubiq entity ID that uniquely identifies an account to register mobile device with

ext-key

External key that uniquely identifies an account to register mobile device with

ext-type

Type of external key

device-id

ID of device to get

Request body:

None

Response body:

JSON data with information about the mobile device

Example 1 – iOS device

{
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992",
	"deviceType": "iOS"
}

Example 2 – Android device with push enabled

{
	"deviceID": "671c6845e85b4873596fcee5da2f1bc25b2d038a710c12bf992",
	"deviceType": "Android",
	"push": true
}

Status codes:

200

Mobile device fetched successfully

404

Account was not found

The following sub codes may be returned:

404.1	User not found
404.2	External user could not be found
404.4	This user has not been registered or This device has not been registered