AT&T DevEx

Omni APIs Central | Wireline Solutions | Service Existing Fiber

ABP | Retrieve Available Promotions

download iconDownload spec

Endpoint

POST
/msapi/productoffermanagementms/v3/product/availability

This API is designed to fetch the available promotions for all tender types

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
                              curl --request POST \
     --url https://example.com/msapi/productoffermanagementms/v3/product/availability \
     --header 'accept: application/json' \
     --header 'authorization: Basic bTIzOTgwQGlkcC5hdHQuY29tOmlkcEs4c3J2Y3NBdXRoMjAyMW5wISE=' \
     --header 'content-type: application/json' \
     --data '
{
  "accountNumber": "552321458441",
  "productType": "BROADBAND",
  "mode": "AutoBillPay",
  "reasonCode": "FMS-ABPENR",
  "intent": "Optin"
}
'

                              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"
                    }
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}