AT&T DevEx

Omni APIs Central | Wireline Solutions | Partners | Service Existing Fiber | Change 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": "23114 38th Ave SE",
  "addressLine2": "APT 123",
  "addressType": "Shipping, Billing",
  "productCategory": "Fiber",
  "city": "CHOLA VISTA",
  "zipCode": "98021",
  "stateOrProvince": "WA"
}
'

    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
    {
  "validationResult": "success",
  "validationResultCode": "4S80",
  "validGeographicAddress": {
    "id": "00000NG3XH",
    "streetNumber": "3802",
    "streetName": "MAIN",
    "streetType": "ST",
    "city": "CHULA VISTA",
    "stateOrProvince": "CA",
    "zipCode": "91911",
    "zipCodeExt": "6247",
    "geographicSubAddress": [
      {
        "subUnitType": "STE",
        "subUnitNumber": "5",
        "subAddressType": "H"
      }
    ],
    "addressCharacteristic": [
      {
        "addressLine1": "3802 MAIN ST STE 5",
        "city": "CHULA VISTA",
        "county": "cook"
      }
    ]
  },
  "validationTypeRecommendation": [
    {
      "validationType": "BILLING",
      "validationRecommendation": "ACCEPT"
    },
    {
      "validationType": "SHIPPING",
      "validationRecommendation": "ACCEPT"
    }
  ]
}