AT&T DevEx

MVNX API

  • Contact Us

    • Check service technical eligibility

    Version 4.0.0
    download iconDownload spec

    Endpoint

    POST
    undefined/checkServiceQualification

    Check service qualification details for a specified service based on address or zipcode. Returns details of the available wireless services. (TMF 645)

    arrowSecurity

    oauth2

    Get a JWT Token from AT&T's Azure AD
    x-amf-describedBy:
    headers:
    Authorization:
    responses:
    200:
    body:
    application/json:
    properties:
    token_type:
    default:Bearer
    example:Bearer
    expires_in:
    format:int
    ext_expires_in:
    format:int
    access_token:
    example:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
    400:
    body:
    application/json:
    properties:
    error:
    example:unauthorized_client
    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
    error_codes:
    items:
    format:int
    timestamp:
    example:2021-06-30 21:12:34Z
    trace_id:
    example:b82bea2f-5ee3-48a4-9774-4143176a6900
    correlation_id:
    example:b57403ef-e775-49f6-b40f-009ba759c301
    error_uri:
    example:https://login.microsoftonline.com/error?code=700016
    x-amf-settings:
    authorizationGrants:
    0:client_credentials
    clientCredentials:
    tokenUrl:https://login.microsoftonline.com/e741d71c-c6b6-47b0-803c-0f3b32b07556/oauth2/v2.0/token
    scopes:
    *:
    arrowRequest

    Query Parameters

      Header Parameters

              Body Parameters

              Responses

              Success -- the result of the service qualification will be found in the qualificationResult element of the response: "qualified" or "unqualified"

              arrowBody

              application/json

              REQUEST

              1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
              curl --request POST \
     --url 'https://example.com/checkServiceQualification?@type=string' \
     --header 'Accept: string' \
     --header 'Authorization: string' \
     --header 'X-ATT-ClientId: string' \
     --header 'X-ATT-CorrelationId: string' \
     --header 'content-type: application/json' \
     --data '
{
  "serviceQualificationItem": [
    {
      "service": {
        "id": "SVC-400",
        "@type": "string"
      }
    }
  ],
  "@type": "string"
}
'

              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
              {
  "state": "done",
  "qualificationResult": "string",
  "id": "string",
  "serviceQualificationItem": [
    {
      "id": "string",
      "qualificationResult": "string",
      "state": "string",
      "service": {
        "id": "SVC-400",
        "name": "Wireless Network Coverage",
        "serviceType": "WNC",
        "@type": "string",
        "@baseType": "string",
        "feature": [
          {
            "id": "string",
            "name": "string",
            "featureCharacteristic": [
              {
                "id": "string",
                "name": "string",
                "valueType": "string"
              }
            ]
          }
        ],
        "place": [
          {}
        ]
      },
      "eligibilityUnavailabilityReason": [
        {
          "code": "string",
          "label": "string"
        }
      ]
    }
  ],
  "checkServiceQualificationDate": "2026-05-06T12:26:32.044Z",
  "@type": "string",
  "@baseType": "string"
}