API Reference
This API lets your app retrieve the device info data.
The device data can be accessed after the user allows your application to retrieve data on his/hers behalf, using OAuth.
- To obtain end user consent, the end user s device must be turned on and have a valid SIM-card, your app needs to use a cross site Ajax call to a Telenor service. This code example and technical walk through demonstrate how this works.
- Your app can display a button or other symbol that will allow the user to trigger the flow
- User is routed through the consent flow.
- If you get the consent, you will in the end have access to retrieve the customer's info.
- You call GET /device to get the device type and capabilites.
For developers, the raw swagger doc for the whole API product can be found in one place here
mobile-device-info
GET
/mobile-device-info/v1/device
Returns information about the mobile device in use by the subscription
Implementation notes
Parameters
-
Authorization*
-
The authorization header containing the access token. See the oauth-v2 API for how to obtain the token. Example: "Authorization: Bearer 065d160140eea13e72cde31a7b857bbfa37390e5"
-
header
-
string
Response class (Status 200)
- modelstring
- The device model, for instance "iPhone 7"
- manufacturerstring
- The device manufacturer of the device, for instance "Apple"
- tacstring
- The TAC (Type Allocation Code) of the device
- capabilitiesCapabilities
- The capabilities that this device has when connected to Telenor network
Capabilities
- hdVoiceboolean
- High definition voice means that your device is enabled to talk to other subscribers in high definition sound quality. If this parameter is not set it means it is not known if it is supported or not
- lteboolean
- lte, or 4G, means that your device can communicate with our 4G network. If this parameter is not set it means it is not known if it is supported or not
- lteAdvancedboolean
- lte Advanced, or 4G+, means that your device can communicate with our 4G+ network. If this parameter is not set it means it is not known if it is supported or not
- voiceOverLTEboolean
- Voice over lte means that you can make phone calls when connected to our 4G network. If this parameter is not set it means it is not known if it is supported or not
- voiceOverWiFiboolean
- Voice over WiFi means that you can make phone calls through a WiFi network. If this parameter is not set it means it is not known if it is supported or not
- nfcboolean
- Near-field communication (nfc) is a set of communication protocols that enable two electronic devices, one of which is usually a portable device such as a smartphone, to establish communication by bringing them within 4 cm of each other. If this parameter is not set it means it is not known if it is supported or not
{ "model": "Xperia Z5", "manufacturer": "Sony Mobile Communications", "tac": "35428717", "capabilities": { "hdVoice": "N/A", "lte": "N/A", "lteAdvanced": "N/A", "voiceOverLTE": "N/A", "voiceOverWiFi": "N/A", "nfc": "N/A" } }
Error responses
- 400
- Bad Request:
Error code 40001 - Missing or invalid enduserId
- 401
- Unauthorized:
Error code 40101 - Invalid resource
Error code 40102 - Missing authorization header
Error code 40103 - No API product found
Error code 40104 - Not authorized to use given MSISDN
Error code 40105 - Invalid access token
Error code 40106 - Access token expired
Error code 40107 - Basic authentication not allowed for external access or not allowed for client
Error code 40108 - Invalid client id or secret for basic authentication
- 403
- Forbidden:
Error code 40301 - Invalid scope
- 404
- Not Found:
Error code 404001 - Mobile Device Not Found
Error code 40401 - Path or method not found
Error code 4042000 - Path or method not found on back-end server
- 429
- Too Many Requests:
Error code 42901 - Rate limit quota violation
Error code 42902 - Spike arrest violation
- 500
- Internal Server Error:
Error code 500001 - Internal server error
Error code 500002 - Internal server error
Error code 50001 - Internal Server Error
Error code 50002 - Failed to validate acr
Error code 50003 - Failed to validate subscription
- 503
- Service Unavailable:
Error code 503001 - External server error