AT&T DevEx

Omni APIs Central | Wireline Solutions | Service Existing Fiber

AP | Add Coverage

download iconDownload spec

Endpoint

POST
/msapi/shopping-cart/v1/carts/****/items

This API is designed to amend the coverage

arrowRequest

Header Parameters

                              Body Parameters

                              Responses

                              OK

                              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
                              curl --request POST \
     --url 'https://example.com/msapi/shopping-cart/v1/carts/****/items' \
     --header 'accept: application/json' \
     --header 'authorization: Basic bTIzOTgwQGlkcC5hdHQuY29tOmlkcEs4c3J2Y3NBdXRoMjAyMW5wISE=' \
     --header 'content-type: application/json' \
     --data '
{
  "items": [
    {
      "itemType": "Coverage",
      "offerId": "b474f34f-5c2b-4501-99dd-28ef9e60dcff",
      "quantity": 1,
      "product": {
        "productRelationship": [
          {
            "relationshipType": "commercialRelation",
            "relationshipSubtype": "5d617faf-cf17-46ec-b9b0-b6073ab3b9bf"
          }
        ],
        "place": [
          {
            "id": "00001NXJTR",
            "role": "SA",
            "name": "ServiceAddress"
          }
        ],
        "characteristic": [
          {
            "name": "productType",
            "value": "FIBER"
          },
          {
            "name": "primaryProductOfferingId",
            "value": "b5d96af0-30bc-4988-92b9-7798cc9d4f93"
          }
        ]
      }
    },
    {
      "itemType": "Equipment",
      "offerId": "3be36e21-9fb4-4fe9-aaa8-fb2ebac818dc",
      "rootBundleProductOfferId": "b474f34f-5c2b-4501-99dd-28ef9e60dcff",
      "groupOptionId": "ef71ddff-5099-11ef-8590-031065163c5f",
      "quantity": 1,
      "product": {
        "place": [
          {
            "id": "00001NXJTR",
            "role": "SA",
            "name": "ServiceAddress"
          }
        ]
      }
    }
  ]
}
'

                              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
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
                              {
  "content": {
    "availableProducts": [
      {
        "eligibility": true,
        "productDetails": [
          {
            "productType": "BBOffer",
            "displayName": "Fiber",
            "eligibility": true,
            "productOfferingRelationship": [
              {
                "type": "discounts",
                "value": [
                  {
                    "id": "a50ea9a8-6c11-4410-afc5-6e9e89c39559",
                    "name": "Price includes $10/mo. discount when you sign up for paperless billing and AutoPay with a debit card or bank account. Or $5/mo. with a credit card.",
                    "description": "Price includes $10/mo. discount when you sign up for paperless billing and AutoPay with a debit card or bank account. Or $5/mo. with a credit card.",
                    "applyPolicy": "automatic",
                    "total": 10,
                    "uom": "month",
                    "tenderType": [
                      "ACH"
                    ],
                    "duration": {
                      "startDateTime": "2025-04-13T05:00:00Z",
                      "endDateTime": "2035-07-04T10:35:16.971Z"
                    }
                  },
                  {
                    "id": "b036ca6f-65b5-4726-a88d-b753f6050adf",
                    "name": "Price includes $10/mo. discount when you sign up for paperless billing and AutoPay with a debit card or bank account. Or $5/mo. with a credit card.",
                    "description": "Price includes $10/mo. discount when you sign up for paperless billing and AutoPay with a debit card or bank account. Or $5/mo. with a credit card.",
                    "applyPolicy": "automatic",
                    "total": 10,
                    "uom": "month",
                    "tenderType": [
                      "DebitCard"
                    ],
                    "duration": {
                      "startDateTime": "2025-04-13T05:00:00Z",
                      "endDateTime": "2035-07-04T10:35:18.136Z"
                    }
                  },
                  {
                    "id": "bd00b6cb-b5fc-41ee-a5dc-c6811c5a93b2",
                    "name": "AutoPay & paperless billing discount ($5/mo. with credit card)",
                    "description": "AutoPay & paperless billing discount ($5/mo. with credit card)",
                    "applyPolicy": "automatic",
                    "total": 5,
                    "uom": "month",
                    "tenderType": [
                      "CreditCard"
                    ],
                    "duration": {
                      "startDateTime": "2025-04-13T05:00:00Z",
                      "endDateTime": "2035-07-04T10:35:17.648Z"
                    }
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}