What is Address Parsing?
Our Address Parser transforms messy address strings into structured data gold. Here's everything you need to know about supercharging your fintech solutions with intelligent address parsing.
Address parsing breaks down unstructured address strings into structured components (street number, street name, city, state, zip code, country, etc.).
For example:
Unstructured address:
123 Main St, Apt 4B, New York, NY 10001
Parsed result for :
{
"house_number": "123",
"road": "Main St",
"unit": "Apt 4B",
"city": "New York",
"state": "NY",
"postcode": "10001"
}
Why Use Address Parsing?
Address Parser provides significant value for fintech clients handling Bill Pay, AP, etc, use case:
Payment Accuracy: Validate addresses to ensure payments reach the correct destination
Fraud Prevention: Enable automated address verification for compliance checks
Location Analytics: Facilitate geocoding for spatial analytics and reporting
Improved UX: Streamline data entry by automatically populating address fields
Development Efficiency: Save engineering resources by eliminating the need to build custom parsing solutions
What Endpoints and Fields have Address Parsing?
Receipts / Invoices OCR API
API Docs
https://api.veryfi.com/api/v8/partner/documentsFields: Vendor Address, Vendor Bank Address, Bill to Address, Ship to Address
W-9 Forms OCR API
API Docshttps://api.veryfi.com/api/v8/partner/w9sFields: Submitter Address
Business Cards OCR API
API Docs
https://api.veryfi.com/api/v8/partner/business-cardsFields: Contact Address
How to Enable Address Parsing?
Simply add "parse_address": true to your API request body to receive parsed address components.
What Fields Are Returned?
We return only the fields found in the address. Possible fields include:
Field | Description | Example |
| Venue or building name | "San Francisco Museum of Modern Art" |
| Building/street number | "123" |
| Street name | "Main St" |
| Apartment, unit, office | "Apt 4B" |
| Floor number | "5th Floor" |
| Combined house_number + road | "123 Main St" |
| City, town, village | "San Francisco" |
| First-level administrative division | "CA" |
| Postal/ZIP code | "94401" |
| Country name | "United States" |
| ISO-3166 country code | "US" |
| Neighborhood name | "Richmond" |
| Borough or district | "Brooklyn" |
| Post office box | "PO Box 12345" |
| County or second-level division | "San Mateo County" |
| Island name | "Maui" |
| Informal country subdivision | - |
| Broader regional designation | "West Indies" |
Example Usage
Request:
{
"parse_address": true,
"file_url": "https://example.com/receipt.jpg"
}
Response:
{
"vendor": {
"address": "3221 Vineland Rd, Kissimmee, FL 34746, United States"
},
"parsed_address": {
"house_number": "3221",
"road": "Vineland Rd",
"street_address": "3221 Vineland Rd",
"city": "Kissimmee",
"state": "FL",
"postcode": "34746",
"country": "United States",
"country_alpha_2": "US"
}
}
Common Use Cases
E-commerce: Validate shipping addresses for accurate delivery
Logistics: Route packages efficiently based on structured address data
Geographic Information Systems: Map and locate addresses accurately
Location-Based Services: Provide relevant recommendations based on location
Fintech: Process payments with verified address information
For more details, please refer to the Veryfi API Documentation.