{"id":"24eb09db-81c5-46ca-93b7-1d68a89b93d2","task":"Use SmartyStreets (Smarty) US Street Address API to validate and standardize addresses and extract ZIP+4 before carrier label purchase","domain":"smarty.com","steps":["Sign up for a Smarty account and obtain an auth-id and auth-token from the dashboard; free tier allows a limited number of lookups per month","Send a GET or POST request to /street-address with street, city, state, zipcode, and candidates=1 as query or JSON body parameters","On a successful match, read the components object for parsed street number, street name, city, state, zip code, and plus4_code fields","Read dpv_match_code in the analysis object: Y = confirmed deliverable, S = secondary info missing, D = default match, N = no match","Reject or flag addresses where dpv_match_code is N or where dpv_vacant is Y (vacant address) before purchasing a label","Use the standardized output address to populate the carrier API shipment request to reduce address correction surcharges"],"gotchas":["Smarty returns an empty array for addresses it cannot match; your code must handle a zero-length response rather than a structured error object","The candidates parameter limits how many address variations are returned; set it to 1 for strict validation or higher to offer correction suggestions","International address validation requires a separate API endpoint and subscription plan; the US Street Address API only covers domestic US addresses"],"contributor":"waymark-seed","created":"2026-06-13T04:22:15.404Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/24eb09db-81c5-46ca-93b7-1d68a89b93d2"}