AT&T MVNX API

Retrieve Bucket Details

Version 4.0.0
download iconDownload spec

Endpoint

GET
https://serverRoot/tmf-api/prepayBalanceManagement/v4/bucket

For a given logical resource (MSISDN), it retrieve a list of either service bucket/s, money bucket/s or both. (TMF 654)

arrowSecurity

oauth2

Get a JWT Token from AT&T's Azure AD
x-amf-settings:
securedBy:
authorizationCode:
scopes:
tokenUrl:https://login.microsoftonline.com/xxxxxxxxxx/oauth2/v2.0/token
authorizationUrl:https://login.microsoftonline.com/xxxxxxxxxx/oauth2/v2.0/token
x-amf-describedBy:
headers:
Authorization:
responses:
200:
body:
application/json:
properties:
token_type:
default:Bearer
example:Bearer
expires_in:
format:int
access_token:
example:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
ext_expires_in:
format:int
400:
body:
application/json:
properties:
error:
example:unauthorized_client
trace_id:
example:b82bea2f-5ee3-48a4-9774-4143176a6900
timestamp:
example:2021-06-30 21:12:34Z
error_uri:
example:https://login.microsoftonline.com/error?code=700016
error_codes:
items:
format:int
correlation_id:
example:b57403ef-e775-49f6-b40f-009ba759c301
error_description:
example:AADSTS700016: Application with identifier '6bb2748d-d916-4534-9145-ee8f598d2e01' was not found in the directory 'e741d71c-c6b6-47b0-803c-0f3b32b07556'. This can happen if the application has not been installed by the administrator of the tenant or consented to by any user in the tenant. You may have sent your authentication request to the wrong tenant.\r\nTrace ID: b82bea2f-5ee3-48a4-9774-4143176a6900\r\nCorrelation ID: b57403ef-e775-49f6-b40f-009ba759c301\r\nTimestamp: 2021-06-30 21:12:34Z
arrowRequest

Query Parameters

    • [
      {
      }
      ]

      Body Parameters

      Responses

      Success

      arrowBody

      application/json

        REQUEST

        1
2
3
        curl --request GET \
     --url 'https://serverroot/tmf-api/prepayBalanceManagement/v4/bucket?@type=array&logicalResource.value=string&logicalResource.@type=string' \
     --header 'accept: application/json'

        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
        {
  "value": [
    {
      "id": "9992220006",
      "href": "/bucket/9992220006?@type=ResellerMobileLineMoneyBucket",
      "description": "bucket for monetary balance and basic subscription information",
      "name": "Money Bucket",
      "logicalResource": [
        {
          "id": "9992220006",
          "@type": "MSISDN",
          "value": "9992220006"
        }
      ],
      "accountInformation": {
        "accountNumber": "123456789007",
        "market": "GAC",
        "submarket": "706",
        "accountType": "reseller",
        "activationDate": "2024-03-12T00:00:00.00Z",
        "airtimeExpirationDate": "2024-03-14T00:00:00.00Z",
        "serviceCancelDate": "2024-05-13T00:00:00.00Z",
        "subscriptionStatus": "available"
      },
      "remainingValue": {
        "quantity": 40,
        "units": "USD"
      },
      "ratePlanInformation": {
        "ratePlanCode": "TST01",
        "ratePlanStatus": "active",
        "ratePlanExpirationDate": "2024-03-14T00:00:00.00Z"
      },
      "activeFeatures": [
        "CFC",
        "CFI",
        "CH",
        "CLI",
        "CW"
      ],
      "autoRenewInformation": {
        "autoRenewStatus": "enrolled",
        "autoRenewExecutionDate": "2024-12-04T00:00:00.00Z"
      },
      "@type": "ResellerMobileLineMoneyBucket"
    },
    {
      "id": "ADD_INT_ROAM_VOICE_NA_30D-9992220006",
      "href": "/bucket/ADD_INT_ROAM_VOICE_NA_30D-9992220006?@type=ResellerMobileLineServiceBucket",
      "description": "bucket for service balance information",
      "remainingValue": {
        "quantity": 20,
        "units": "SECONDS"
      },
      "totalQuantity": {
        "quantity": 2199023254528,
        "units": "SECONDS"
      },
      "name": "ADD_INT_ROAM_VOICE_NA_30D",
      "serviceCode": "RATEPLAN_ADD_LIMITED_SERVICE",
      "refillAmount": {
        "quantity": -1,
        "units": "SECONDS"
      },
      "serviceExpirationDate": "2024-05-13T00:00:00.00Z",
      "logicalResource": [
        {
          "id": "9992220006",
          "@type": "MSISDN",
          "value": "9992220006"
        }
      ],
      "@type": "ResellerMobileLineServiceBucket"
    }
  ]
}