Address Validation

ShipGenius validates and normalizes shipping addresses before you rate or generate a label. Running validation upfront catches problems early — before they turn into carrier surcharges, failed deliveries, or returned packages.

Why Address Validation Matters

Carriers apply address correction fees when they have to fix a bad address in transit, and some undeliverable addresses result in packages being returned to sender at your expense. Validating before label purchase catches these issues when they're cheap to fix — a prompt to the user — rather than after the package is already in the network.

Validation also normalizes address formatting to match what USPS and UPS expect, which improves routing accuracy and reduces the chance of a surcharge being applied after the fact.

For platforms doing cartonization or rate shopping, clean validated addresses also improve the accuracy of downstream calculations.

How It Works

ShipGenius runs address validation against USPS and UPS APIs for most U.S. addresses. The validation step checks that the address exists and is deliverable, and normalizes formatting to carrier standards. This can include changes like expanding abbreviations — for example, Ste becomes Suite, or CA becomes California — depending on what the carrier APIs return.

The validated address is what ShipGenius uses for rating and label generation. If you store the result and use it consistently across your shipment, you avoid any mismatch between what was validated and what ends up on the label.

Best Practices

• Always validate before rating or purchasing a label. Validation is a fast call and catching a bad address at this stage costs nothing.
• Store the validated address result and use it for all subsequent steps in the shipment — rating, label creation, and any downstream fulfillment logic.
• If an address fails validation, prompt the user to correct it manually or confirm they want to proceed as-is. Some addresses — particularly rural or newly constructed locations — may not validate cleanly even when they're real.
• For bulk imports or API integrations, run validations in batch before fulfillment begins rather than one at a time during the ship flow. This surfaces address problems earlier and keeps the fulfillment process moving.

Notes and Limitations

• Validation is currently available for most U.S. addresses via the USPS and UPS APIs. International address validation coverage varies.
• Normalization may modify fields in your input — abbreviations may be expanded, state names may be reformatted, and suite or unit designators may be standardized to match carrier requirements.
• A successful validation result means the address is recognized and formatted correctly — it does not guarantee the recipient is reachable at that address.

FAQs

What happens if an address can't be validated?

ShipGenius will return a validation result indicating the address couldn't be confirmed. You can still proceed with label generation, but we recommend prompting the user to review and correct the address first. Shipping to an unvalidated address increases the risk of a carrier surcharge or failed delivery.

Will validation change the address I entered?

It can. Normalization adjusts formatting to match carrier standards — abbreviations may be expanded and fields may be reformatted. Always use the validated result rather than your original input for rating and label creation to ensure consistency.

Is address validation available for international shipments?

Validation is available for most U.S. addresses via USPS and UPS. International coverage varies by country and carrier.

Does validation guarantee delivery?

No. A validated address means the address is recognized by the carrier APIs and formatted correctly. It doesn't confirm the recipient is present or that the address is currently occupied.