AT&T MVNX API

Update Port

Version 1.0.0
download iconDownload spec
View Use Cases

Endpoint

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

Change information associated with the current active port request

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
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
curl --request POST \
     --url https://lgw.att.com/UpdatePort \
     --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:38.821Z",
      "conversationId": "string",
      "applicationName": "string",
      "originalVersion": "string",
      "uniqueTransactionId": "string",
      "infrastructureVersion": "string",
      "originalInfrastructureVersion": "string"
    },
    "SecurityMessageHeader": {
      "userName": "string",
      "userPassword": "string"
    },
    "SequenceMessageHeader": {
      "sequenceNumber": "string",
      "totalInSequence": "string"
    }
  },
  "UpdatePortRequest": {
    "Customer": {
      "Name": {
        "lastName": "string",
        "firstName": "string",
        "namePrefix": "string",
        "middleName": "string",
        "nameSuffix": "string",
        "additionalTitle": "string"
      },
      "Address": {
        "Zip": {
          "zipCode": "string",
          "zipGeoCode": "string",
          "zipCodeExtension": "string"
        },
        "Unit": {
          "unitNumber": "string",
          "unitDesignator": "APT"
        },
        "City": "string",
        "State": "JA",
        "Street": {
          "streetName": "string",
          "streetType": "ALY",
          "streetNumber": "string",
          "streetDirection": "E",
          "streetTrailingDirection": "E"
        },
        "Country": "string",
        "RuralRoute": {
          "ruralRouteBoxNumber": "string",
          "ruralRouteCenterNumber": "string"
        },
        "PostOfficeBox": "string"
      },
      "BusinessName": {
        "contact": {
          "lastName": "string",
          "firstName": "string",
          "namePrefix": "string",
          "middleName": "string",
          "nameSuffix": "string",
          "additionalTitle": "string"
        },
        "businessName": "string"
      }
    },
    "portPath": "O",
    "Commission": {
      "dealer": {
        "code": "string",
        "secondaryCode": "string"
      },
      "location": "string",
      "customerCode": "string",
      "DualCommission": {
        "creditCheckAgent": "string",
        "creditCheckAgentLocation": "string"
      },
      "salesRepresentative": "string",
      "affiliateSalesRepCode": "string",
      "billingTelephoneNumber": "string"
    },
    "PortRequest": {
      "initiatorId": "string",
      "immediateAct": "U",
      "portDirection": "A",
      "businessTaxId": "string",
      "requestRemarks": "string",
      "desiredDueDate": "2025-04-01T12:10:38.821Z",
      "authorizationName": "string",
      "termsConditionStatus": "B",
      "socialSecurityNumber": "string",
      "ospBillingAccountNumber": "string",
      "ospBillingAccountPassword": "string",
      "totalNumberOfSubscriberNumbers": 0
    },
    "PortOutInfo": {
      "remark": "string",
      "dueDate": "2025-04-01T12:10:38.821Z",
      "delayCode": "",
      "responseType": "string",
      "PortOutMdnInfo": [
        {
          "mdn": "string",
          "reasonCode": "string",
          "rsnCdDetail": "string"
        }
      ]
    },
    "PortingSelector": {
      "PortingLocator": {
        "portRequestNumber": "string",
        "portRequestVersion": "string",
        "teleportPortRecordId": "string"
      },
      "SubscriberNumber": "string",
      "PortOutListDateRange": {
        "toDate": "2025-04-01",
        "fromDate": "2025-04-01"
      }
    },
    "PortRequestLine": [
      {
        "npaNxx": "string",
        "toLine": "string",
        "fromLine": "string",
        "serviceArea": "string",
        "equipmentType": "C",
        "portRequestLineId": 0,
        "fulfillmentOrderId": "string",
        "replaceDeleteFromPortRequest": "R",
        "cingularReplacementSubscriberNumber": "string"
      }
    ],
    "MarketServiceInfo": {
      "productType": "C",
      "billingMarket": {
        "localMarket": "string",
        "billingMarket": "string",
        "billingSubMarket": "string"
      },
      "serviceZipCode": "string",
      "billingSystemId": "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
{
  "MessageHeader": {
    "TrackingMessageHeader": {
      "version": "v185",
      "messageId": "",
      "timeToLive": 300000,
      "dateTimeStamp": "2023-08-31T17:08:57Z",
      "conversationId": "XXXXXXXXXXXXXX~CNG-CSI~a9fd5bc8-6a66-4429-916e-6b764d2e9cc7",
      "originalVersion": "v185",
      "uniqueTransactionId": "ServiceGateway321838@qzlty22047c01_00ca6eac-c6bc-4033-95a1-cf705192c526"
    },
    "SecurityMessageHeader": {
      "userName": "[userName]",
      "userPassword": "[userPassword]"
    },
    "SequenceMessageHeader": {
      "sequenceNumber": "1",
      "totalInSequence": "1"
    }
  },
  "UpdatePortResponse": {
    "Response": {
      "code": "0",
      "description": "Success"
    },
    "PortingLocator": {
      "portRequestNumber": "6214023283771641"
    },
    "PortRequestStatus": "CT"
  }
}