AT&T DevEx

Omni APIs Central | Wireless Solutions | Mobile Device Protection

Add Items to Cart

Version 1.0.3
download iconDownload spec

Endpoint

POST
https://partner.att.com/omni-svcs/v1/carts/{cartId}/items

Add one or more items to an existing shopping cart. Items can include products, devices, services, or accessories. This operation updates the cart pricing and validates item compatibility.

arrowRequest

Request containing cart items to be added, including product offerings, billing account information, and product details

Path Parameters

    Header Parameters

        Body Parameters

        Responses

        Items successfully added to cart. Returns the updated ProductOrder object with recalculated pricing and updated item list.

        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
        curl --request POST \
     --url https://partner.att.com/omni-svcs/v1/carts/string/items \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "items": [
    {
      "action": "noChange",
      "productOfferingType": "Mobile_Offer",
      "productOfferingId": "0b690f7e-3f41-49bf-a6cf-6f65caa650ca",
      "productOrderItemId": "10000001-3f41-49bf-a6cf-6f65caa650ca",
      "billingAccount": {
        "ratingType": "postpaid",
        "id": "556165899573"
      },
      "subscriberNumber": "4690002221"
    },
    {
      "productOfferingType": "Mobile_Device",
      "action": "terminate",
      "rootBundleProductOrderItemId": "10000001-3f41-49bf-a6cf-6f65caa650ca",
      "actionReason": {
        "reasonText": "Memo text required if selected",
        "name": "LC"
      },
      "product": {
        "id": "47777581441708014",
        "primaryProductId": "47777581441708014"
      }
    },
    {
      "action": "swap;add",
      "productOfferingType": "Mobile_Device",
      "productOfferingId": "Mobile_Device_pkey73001_sku2680262",
      "rootBundleProductOrderItemId": "10000001-3f41-49bf-a6cf-6f65caa650ca",
      "actionReason": {
        "reasonText": "Memo text required if selected",
        "name": "LC",
        "action": "swap"
      },
      "product": {
        "place": [
          {
            "role": "PPU",
            "name": "ppuAddress",
            "id": "000011VYAA"
          }
        ]
      },
      "characteristic": [
        {
          "name": "isBYOD",
          "value": "true"
        },
        {
          "name": "IMEI",
          "value": "358073464620280"
        },
        {
          "name": "eSIM_Enabled",
          "value": "true"
        }
      ]
    },
    {
      "productOfferingType": "SIM",
      "action": "terminate",
      "rootBundleProductOrderItemId": "10000001-3f41-49bf-a6cf-6f65caa650ca",
      "actionReason": {
        "reasonText": "Memo text required if selected",
        "name": "LC"
      },
      "product": {
        "id": "47777581441708014",
        "primaryProductId": "47777581441708014"
      }
    },
    {
      "productOfferingType": "SIM",
      "productOfferingId": "790650ec-b512-4bee-ae7f-535668eadf1b",
      "rootBundleProductOrderItemId": "10000001-3f41-49bf-a6cf-6f65caa650ca",
      "action": "swap;add",
      "actionReason": {
        "reasonText": "Memo text required if selected",
        "name": "LC"
      },
      "characteristic": [
        {
          "name": "ICCID",
          "value": "89014103270197479933"
        }
      ]
    }
  ]
}
'

        RESPONSE

        1
2
3
        {
  "externalId": "26-46236265737394"
}