AT&T DevEx

Omni APIs Central | Wireless Solutions | Mobile Device Protection

Product & Offers

Version 1.0.5
download iconDownload spec

Endpoint

POST
https://partner.att.com/omni-svcs/v1/offers/search

Retrieve list of product offers based on eligibility and filter criteria. Appropriate promotions/rewards cards will be returned based on service address, channel and customer's intent.

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
    curl --request POST \
     --url https://partner.att.com/omni-svcs/v1/offers/search \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "productOfferingTypeGroup": "mobileDevice",
  "customerType": "CONSUMER",
  "BYOD": {
    "edModels": "iPh11PMA2161"
  },
  "deviceType": [
    "Phone"
  ]
}
'

    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
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
    [
  {
    "id": "06c387fb-bfd5-4287-a1e8-b9da4c0be06e",
    "name": "Value Plus VL",
    "localizedName": "Value Plus VL",
    "description": "Value Plus VL",
    "productOfferingType": "Mobile_Offer",
    "productOfferingTypeGroup": "mobileOffer",
    "bundledProductOffering": [
      {
        "id": "75c62382-0601-40a9-bc0b-05e7e153fa38",
        "name": "Value Plus VL",
        "productOfferingType": "Mobile_Plan",
        "productOfferingTypeGroup": "mobilePlan",
        "bundledProductOfferingOption": [
          {
            "productOfferingPrice": [
              {
                "name": "Value Plus VL",
                "priceCategory": "serviceRC",
                "priceType": "RC",
                "recurringChargePeriod": "month",
                "recurringChargePeriodLength": 1,
                "role": "Price",
                "price": {
                  "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 60.99
                  }
                },
                "finalPrice": {
                  "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 60.99
                  }
                },
                "standalonePrice": {
                  "dutyFreeAmount": {
                    "unit": "USD",
                    "value": 60.99
                  }
                },
                "taxIncluded": "Excluded"
              }
            ]
          }
        ]
      },
      {
        "id": "3e841296-e828-4c13-adf1-3115f6ccb614",
        "name": "AT&T ActiveArmor",
        "productOfferingType": "Active_Armor",
        "productOfferingTypeGroup": "mobileAddon"
      },
      {
        "id": "1e6d9cf0-13cc-49a9-9e19-907ef46d6eb3",
        "name": "International Day Pass",
        "productOfferingType": "Roaming_Package",
        "productOfferingTypeGroup": "mobileAddon"
      }
    ],
    "productOfferingTotalPrice": [
      {
        "priceType": "RC",
        "recurringChargePeriod": "month",
        "recurringChargePeriodLength": 1,
        "price": {
          "dutyFreeAmount": {
            "unit": "USD",
            "value": 60.99
          }
        },
        "finalPrice": {
          "dutyFreeAmount": {
            "unit": "USD",
            "value": 60.99
          }
        },
        "standalonePrice": {
          "dutyFreeAmount": {
            "unit": "USD",
            "value": 60.99
          }
        },
        "taxIncluded": "Excluded"
      }
    ],
    "bundledProductOfferingGroupOption": [
      {
        "groupOptionId": "3405d3a9-b60a-11ef-ae7c-ed7e3dc40175",
        "description": "Select SIM Card",
        "bundledProductOffering": [
          {
            "id": "790650ec-b512-4bee-ae7f-535668eadf1b",
            "name": "eSIM Activation",
            "productOfferingType": "SIM",
            "productOfferingTypeGroup": "sim"
          }
        ]
      },
      {
        "groupOptionId": "3405d3aa-b60a-11ef-ae7c-27965683c6f2",
        "description": "Select Device",
        "bundledProductOffering": [
          {
            "id": "c9715944-afed-42eb-a35f-51c2ced6bea4",
            "name": "Bring Your Own Phone",
            "productOfferingType": "Mobile_Device",
            "productOfferingTypeGroup": "mobileDevice"
          }
        ]
      }
    ]
  }
]