New 42-day free trial
Smarty

Blend data

Identify duplicates & blend datasets with SmartyKey®

Prevent fraud

Detect fake or risky addresses using DPV® (Delivery Point Validation)

Target smarter

Segment by ZIP+4, RDI, and more for hyper-personalized outreach

About metadata

Metadata introduction

When you verify an address with Smarty's US Address Verification, you're not just getting a green checkmark.

You're unlocking a rich dataset packed with insights that can transform how your business ships, communicates, analyzes, and grows.

We call this powerful bundle "metadata"—and it’s so much more than just extra info.

What is address metadata?

Metadata is additional information returned alongside a verified address.

It gives you context, clarity, and confidence in the data you're working with.

Instead of a simple address string, you get a complete profile of the address, including its geographic location precision, delivery readiness, and dozens of other attributes that help you make smarter decisions.

Why metadata matters

Address metadata fuels business-critical decisions across industries. Here are just a few ways:

  • Shipping optimization: Determine whether an address is deliverable, vacant, or a commercial location to avoid failed deliveries and ensure correct postage.
  • Fraud prevention: Use metadata like DPV® (Delivery Point Validation) codes to flag suspicious or non-existent addresses.
  • Marketing segmentation: For hyper-personalized campaigns, target by congressional district, ZIP+4, or RDI (Residential Delivery Indicator, which tells you whether the location is residential or commercial).
  • Regulatory compliance: Metadata like County FIPS supports tax jurisdiction and healthcare reporting.
  • Data unification: Match, deduplicate, and unify customer records and blend 3rd-party datasets with SmaryKey®, our persistent, unique identifier.

The 55 metadata fields Smarty provides

Here’s the full lineup of possible metadata returned when verifying a US address with Smarty:

Address structure & delivery info

  • Delivery line 1
  • Delivery line 2
  • Delivery point
  • Delivery point barcode
  • Delivery point check digit
  • Street name
  • Street suffix
  • Street post direction
  • Street prediction
  • Secondary designator
  • Secondary number
  • Primary number
  • SuiteLink® match
  • PMB (Private Mail Box) designator
  • PMB number
  • Extra secondary designator
  • Extra secondary number

Location & Geography

  • City
  • Default city name
  • State
  • ZIP Code
  • ZIP+4
  • ZIP type
  • County name
  • County FIPS (Federal Information Processing Standard)
  • Urbanization
  • Congressional district
  • Latitude
  • Longitude
  • Precision (of latitude and longitude)
  • Time zone
  • UTC (Coordinated Universal Time) offset
  • Observes DST (Daylight Saving Time)

Address verification & delivery readiness

  • Active
  • Vacant
  • RDI (Residential Delivery Indicator)
  • Record type
  • DPV® (Delivery Point Validation) match code
  • DPV® footnotes
  • DPV® no stat
  • EWS (Early Warning System) match
  • LACSLink (Locatable Address Conversion System Link) code
  • LACSLink indicator
  • CMRA (Commercial Mail Receiving Agency)
  • Carrier route
  • eLOT® (enhanced Line of Travel) sequence
  • eLOT® sort
  • Building default indicator

Identity, persistence & input

  • Addressee (if provided by client)
  • Input ID (if provided by client)
  • Input index
  • Candidate index
  • Last line
  • SmartyKey®
  • Footnotes

Want to know exactly what is meant by each data point? See our API doc.

Heads-up: Because available data varies by region, it’s rare for any single address to return all 55 metadata fields. That said, most addresses come packed with the majority of them. Want to see what yours returns? Try our address validation free for 42 days or check a single address using our free address validation tool.

One more thing: Smarty’s ultra-precise US Rooftop Geocoding returns coordinates that land on the property’s roof 97% of the time. You can subscribe to rooftop geocoding at its pricing page. The geocoordinate accuracy level included in the US Address Verification metadata is typically ZIP-9 (commonly referred to as street-centroid). ZIP-9 means we give you the geocoordinates for the center of the ZIP-9, which can be a single commercial building or between 5 and 20 houses on the same street.

Want to know more?

Dive deeper into the metadata that comes with US Address Verification.
01

Complete guide to address data

Get an in-depth overview of address data components.
02

US Address Verification API docs

Get the full list and detailed descriptions of all metadata points.
03

Video: How to check metadata for an address for free

See what data you get when you validate any address.

FAQ

Is address metadata included by default in Smarty’s API response?

Yes. When you verify a US address using Smarty’s API, metadata is included in the response by default—no extra configuration or cost required.

How many metadata fields does Smarty return per address?

Smarty returns up to 55 metadata fields per verified address, covering location, deliverability, structure, and a unique identifier called SmartyKey®.

Do I get all 55 metadata points with every address verification?

Because available data varies by region, it’s rare for any single address to return all 55 metadata fields. That said, most addresses come packed with the majority of them. Want to see what yours returns? Try our address validation free for 42 days or check a single address using our free address validation tool.

Where can I learn what each piece of metadata means?

Find all 55 metadata points and descriptions at Smarty’s US Street API doc.

How does metadata improve address verification?

Metadata provides a deeper layer of accuracy and context. It ensures the address is deliverable, identifies if it's a residential or business location, flags vacant or inactive addresses, and includes geocodes for mapping and analysis.

More FAQs

Select a category to see more information about a certain topic.

How accurate is the geolocation (latitude/longitude) data?

Smarty’s ultra-precise US Rooftop Geocoding returns coordinates that land on the property’s roof 97% of the time. You can subscribe to rooftop geocoding at its pricing page. The geocoordinate accuracy level included in the US Address Verification metadata is typically ZIP-9 (commonly referred to as street-centroid). ZIP-9 means we give you the geocoordinates for the center of the ZIP-9, which can be a single commercial building or between 5 and 20 houses on the same street.

What is DPV® and why is it important?

DPV® (Delivery Point Validation) confirms if an address is deliverable by USPS. It prevents fraud, ensures mailing accuracy, and flags undeliverable or non-existent addresses, making it crucial for ecommerce, finance, logistics, and much more.

Can I use metadata to improve customer segmentation?

Absolutely. Use fields like “ZIP+4,” “Congressional District,” “County FIPS,” and “RDI” to segment customers by region, property type, or delivery likelihood for more effective marketing.

What is SmartyKey® and how is it used?

SmartyKey® is a persistent, unique identifier for each address. It helps you deduplicate, merge datasets, and unify address records across systems with confidence.