AT&T MVNX API

Update Device Profile

Version 1.0.0
download iconDownload spec

Endpoint

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

Updates device information (IMEI, SIM, ESN) for one or more of a subscriber's devices. May also be used to blacklist a given device (by IMEI), and optionally to indicate the reason for the blacklisting and to provide a device stolen date.

arrowRequest

Body Parameters

Responses

The request completed successfully.

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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
curl --request POST \
     --url https://lgw.att.com/UpdateDeviceProfile \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "MessageHeader": {
    "TrackingMessageHeader": {
      "version": "280",
      "messageId": "string",
      "returnURL": "string",
      "responseTo": "string",
      "timeToLive": 0,
      "originatorId": "string",
      "dateTimeStamp": "2025-04-01T12:14:19.993Z",
      "conversationId": "string",
      "applicationName": "CustomerCareProfile",
      "originalVersion": "string",
      "uniqueTransactionId": "string",
      "infrastructureVersion": "86",
      "originalInfrastructureVersion": "string"
    },
    "SecurityMessageHeader": {
      "userName": "string",
      "userPassword": "string"
    },
    "SequenceMessageHeader": {
      "sequenceNumber": "string",
      "totalInSequence": "string"
    }
  },
  "UpdateDeviceProfileRequest": {
    "DeviceProfile": {
      "userId": "string",
      "Device": [
        {
          "SIM": "string",
          "ESN": "string",
          "IMEI": "string",
          "reason": {
            "reasonCode": "string",
            "reasonDescription": "string"
          },
          "Commission": {
            "dealer": {
              "code": "string",
              "secondaryCode": "string"
            },
            "location": "string",
            "customerCode": "string",
            "DualCommission": {
              "creditCheckAgent": "string",
              "creditCheckAgentLocation": "string"
            },
            "salesRepresentative": "string",
            "affiliateSalesRepCode": "string",
            "billingTelephoneNumber": "string"
          },
          "technologyType": "GSM",
          "IMEIDeviceFirmware": {
            "osType": "string",
            "osVersion": "string",
            "softwareVersionNumber": "string",
            "networkActivityDateTime": "2025-04-01T12:14:19.993Z"
          }
        }
      ],
      "salesChannel": "string",
      "subscriberNumber": "string"
    },
    "BlacklistedDevice": {
      "IMEI": "string",
      "userId": "string",
      "reasonCode": "string",
      "subscriberNumber": "string",
      "stolenDeviceDate": "2025-04-01",
      "reasonDescription": "string"
    },
    "UpdateInstallmentPlanDeviceStatus": {
      "mode": "I",
      "imei": "string",
      "occAmount": 0,
      "reasonCode": "string",
      "occIndicator": false,
      "billingMarket": "string",
      "subscriberNumber": "string",
      "installmentPlanID": 0,
      "billingAccountNumber": "string"
    }
  }
}
'

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
{
  "MessageHeader": {
    "TrackingMessageHeader": {
      "version": "280",
      "messageId": "string",
      "returnURL": "string",
      "responseTo": "string",
      "timeToLive": 0,
      "originatorId": "string",
      "dateTimeStamp": "2025-04-01T12:14:19.981Z",
      "conversationId": "string",
      "applicationName": "CustomerCareProfile",
      "originalVersion": "string",
      "uniqueTransactionId": "string",
      "infrastructureVersion": "86",
      "routingRegionOverride": [
        {}
      ],
      "originalInfrastructureVersion": "string"
    },
    "SecurityMessageHeader": {
      "userName": "string",
      "userPassword": "string"
    },
    "SequenceMessageHeader": {
      "sequenceNumber": "string",
      "totalInSequence": "string"
    }
  },
  "UpdateDeviceProfileResponse": {
    "Response": {
      "code": "string",
      "description": "string"
    }
  }
}