{"uid":"cap_3-tefTIYiYQJGw1ZhRw8n","slug":"qonoro-address-normalize-7d895cc0","name":"Qonoro Address Normalize","description":"Parse and normalize postal addresses into structured components. Returns address number, street, city, state, ZIP, and USPS-formatted output. Postal address parsing and normalization. Sub-second. x402-native.","url":"https://api.qonoro.ai/v1/address/normalize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"Raw postal address to normalize."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (default: 'US')."},"buyer_region":{"type":"string","description":"Optional privacy-safe buyer region."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c5I0Nj9_xli87AaAl0IjY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a raw postal address string into structured components (number, street, city, state, ZIP) and returns a USPS-formatted normalized output with confidence score.","exampleAgentPrompt":"Can you parse and normalize this address into structured components — street number, street, city, state, and ZIP — and give me the USPS-formatted version: '123 main st apt 4b new york ny 10001'?","exampleUseCases":[{"title":"E-commerce checkout address cleanup","prompt":"A customer typed '450 lexington ave fl 3 new york ny' into our checkout form — can you normalize it into proper USPS format and break it into street number, street name, city, state, and ZIP?"},{"title":"CRM data standardization","prompt":"I have a raw address from a contact record — '1600 pennsylvania ave nw washington dc 20500' — can you parse it into structured fields and give me the standardized USPS output so I can store it correctly?"},{"title":"Shipping label preparation","prompt":"Before I print a shipping label, can you normalize this address and confirm it parses cleanly: '742 Evergreen Terrace, Springfield IL 62704'? I need the components separated and a confidence score."}],"resultDescription":"Returns a JSON object containing parsed address components (house number, street, city, state, ZIP, etc.), a USPS-formatted normalized address string, a confidence score (0–1), address type classification, optional parse notes, cache hit flag, request ID, and response time in milliseconds.","failureModes":["Unparseable address input returns low confidence score or null normalized field","Non-US address without country code may fail or return incomplete components","Malformed or completely garbled input may return null normalized output with parse_notes explaining the issue","Missing required 'address' field returns a validation error","Ambiguous abbreviations or incomplete addresses may yield lower confidence scores"],"whenToPreferThis":"Choose this endpoint when you need to parse and normalize a single US (or supported country) postal address string into structured components at sub-second latency, especially in agentic workflows requiring USPS-standard output with confidence scoring. Prefer it over geocoding APIs when you need address component decomposition rather than lat/lng coordinates, and over batch file processing services when you need real-time per-address normalization with x402 micropayment billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:43:25.242Z","isFirstParty":false}