AT&T DevEx

Omni APIs Central | Wireless Solutions | Internal Partners | Shop New Prepaid

Find Device By Imei

download iconDownload spec

Endpoint

GET
undefined/msapi/sales/customerdevicelifecycle/v1/activation/validateimei/{deviceImei}

This API endpoint is invoked to get the details about a device. It takes in the __IMEI__ number of the device and returns a json response.This response consists of 3 objects, namely, __deviceDetails__, __deviceUnlockDetails__ and __variantDetails__ depending upon the type of the request. The deviceDetails object contains information like att compatibility, make, model, etc.

arrowRequest

Path Parameters

    Query Parameters

            Header Parameters

                Body Parameters

                Responses

                Success

                arrowBody

                application/json

                REQUEST

                1
2
3
                curl --request GET \
     --url 'https://example.com/msapi/sales/customerdevicelifecycle/v1/activation/validateimei/358758580000000?customerType=firstNet&includeDeviceInfo=false&mode=additionalDeviceInfo&getdevicestatus=true' \
     --header 'accept: application/json;charset=utf-8'

                RESPONSE

                1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
                {
  "content": {
    "deviceDetails": {
      "deviceCategory": "STANDARD",
      "imeiItemId": "PG05100",
      "frequency": "1900",
      "nfcCapability": "N",
      "umtsCapableIndicator": true,
      "imei": "353267079639967",
      "imeiType": "K3",
      "make": "APPLE",
      "model": "iPhone 6s",
      "skuId": "sku7730375",
      "deviceProductId": "prod8420721",
      "stolenDeviceDetails": {
        "blacklistIndicator": "N"
      },
      "deviceEIRInfo": {
        "phoneNumber": "4077758706",
        "blockedInd": "N",
        "eirStatus": "B",
        "reasonCodeList": "Red",
        "blocklistType": "P"
      },
      "attCompatibility": "GREEN",
      "physicalSimCompatible": true,
      "deviceType": "pda",
      "isPhone": true,
      "deviceFriendlyName": "Apple iPhone 6s",
      "encryptedEid": false,
      "deviceStatus": "unlocked",
      "variantGroup": "Apple iPhone 6s",
      "imageKey": "apple-iphone-6s"
    }
  }
}