AT&T DevEx

Omni APIs Central | Wireline Solutions | Partners | Service Existing Fiber | Move Order

Address Validation

Version 1.0.2
download iconDownload spec

Endpoint

POST
https://partner.att.com/omni-svcs/v1/address/validate

The Validate Address endpoint offers real-time verification and normalization of customer postal addresses. It ensures that address data conforms to AT&T’s internal standards and third-party reference (e.g. USPS) before downstream use in ordering, service eligibility checks, billing, or fulfillment. Address Supported are PPU, Billing, Shipping. Key Benefits: 1. Reduces delivery failures and billing errors by catching bad addresses early. 2. Streamlines customer onboarding flows for Apple, SaraPlus, and other national retail partners. 3. Supports AT&T’s MVPD and broadband services with a single, standards-based interface.

arrowRequest

Header Parameters

    Body Parameters

    Responses

    Address validation response

    arrowBody

    application/json

    REQUEST

    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
    curl --request POST \
     --url https://partner.att.com/omni-svcs/v1/address/validate \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "addressLine1": "string",
  "addressLine2": "string",
  "addressType": "string",
  "productCategory": "string",
  "city": "string",
  "zipCode": "string",
  "stateOrProvince": "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
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
    {
  "validationResult": "string",
  "validationResultCode": "string",
  "validationResultDescription": "string",
  "validGeographicAddress": {
    "id": "string",
    "streetNumber": "string",
    "streetName": "string",
    "streetType": "string",
    "city": "string",
    "stateOrProvince": "string",
    "country": "string",
    "zipCode": "string",
    "zipCodeExt": "string",
    "geographicSubAddress": [
      {
        "buildingName": "string",
        "levelNumber": "string",
        "levelType": "string",
        "subUnitNumber": "string",
        "subUnitType": "string",
        "structureType": "string",
        "structureValue": "string",
        "subAddressType": "string"
      }
    ],
    "addressCharacteristic": [
      {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "county": "string"
      }
    ]
  },
  "alternateGeographicAddress": [
    {
      "id": "string",
      "streetNumber": "string",
      "streetName": "string",
      "streetType": "string",
      "streetSuffix": "string",
      "city": "string",
      "stateOrProvince": "string",
      "country": "string",
      "zipCode": "string",
      "zipCodeExt": "string",
      "geographicSubAddress": [
        {
          "buildingName": "string",
          "levelNumber": "string",
          "levelType": "string",
          "subUnitNumber": "string",
          "subUnitType": "string",
          "structureType": "string",
          "structureValue": "string",
          "subAddressType": "string"
        }
      ],
      "addressCharacteristic": [
        {
          "addressLine1": "string",
          "addressLine2": "string",
          "city": "string",
          "county": "string"
        }
      ]
    }
  ],
  "validationTypeRecommendation": [
    {
      "validationType": "BILLING",
      "validationRecommendation": "ACCEPT"
    }
  ]
}