AT&T MVNX API

Inquire Device Status

Version 1.0.0
download iconDownload spec
View Use Cases

Endpoint

POST
https://lgw.att.com/InquireDeviceStatus

Retrieve wireless device status information: indicates if a device is currently blacklisted (i.e., reported as stolen), or previously blacklisted.

arrowRequest

Body Parameters

Responses

success

arrowBody

application/json

REQUEST

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
37
curl --request POST \
     --url https://lgw.att.com/InquireDeviceStatus \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "MessageHeader": {
    "TrackingMessageHeader": {
      "version": "string",
      "messageId": "string",
      "returnURL": "string",
      "responseTo": "string",
      "timeToLive": 0,
      "originatorId": "string",
      "dateTimeStamp": "2025-04-01T12:10:00.597Z",
      "conversationId": "string",
      "applicationName": "string",
      "originalVersion": "string",
      "uniqueTransactionId": "string",
      "infrastructureVersion": "string",
      "originalInfrastructureVersion": "string"
    },
    "SecurityMessageHeader": {
      "userName": "string",
      "userPassword": "string"
    },
    "SequenceMessageHeader": {
      "sequenceNumber": "string",
      "totalInSequence": "string"
    }
  },
  "InquireDeviceStatusRequest": {
    "imei": "string",
    "mode": "DU"
  }
}
'

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
37
38
39
{
  "MessageHeader": {
    "TrackingMessageHeader": {
      "version": "v185",
      "messageId": "",
      "timeToLive": 300000,
      "dateTimeStamp": "2023-08-17T01:14:12Z",
      "conversationId": "XXXXXXXXXXXXXX~CNG-CSI~e39f7c4b-94f3-4789-ae25-50370e534f64",
      "originalVersion": "v185",
      "uniqueTransactionId": "ServiceGateway213542@q100csg107c3_3f05a44d-ac44-42f5-a094-555c560a599e"
    },
    "SecurityMessageHeader": {
      "userName": "[userName]",
      "userPassword": "[userPassword]"
    },
    "SequenceMessageHeader": {
      "sequenceNumber": "1",
      "totalInSequence": "1"
    }
  },
  "InquireDeviceStatusResponse": {
    "Response": {
      "code": "0",
      "description": "Success"
    },
    "DeviceStatusDetails": {
      "imeiType": "W7",
      "frequency": "850",
      "imeiItemId": "PG00246",
      "Manufacturer": {
        "make": "UNKNOWN",
        "model": "unknown GSM"
      },
      "deviceCategory": "STANDARD",
      "attCompatibility": "RED",
      "blacklistedIndicator": "N"
    }
  }
}