addresses

Standardize a US address (CASS-style, not CASS-certified)

Apply USPS abbreviations, extract secondary units, parse components, and produce a deterministic dedup key. Handles PO Box, Drawer, BIN, Rural Route, and military (APO/FPO/DPO) addresses. US only: a postal_code that isn't a ZIP or ZIP+4 is rejected as an is_valid:false verdict with why_invalid — international addresses are out of scope, never silently mangled. NOT USPS-CASS certified — this is a format normalizer, not an address validator. For certified validation use Smarty alongside Snipget.

post/v1/addresses/standardize

Request

  • Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.snipget.ai/v1/addresses/standardize
  • Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

line_1string

Primary address line.

line_2string

Secondary address line (unit, etc.).

postal_codestring

ZIP code (5-digit, 9-digit, or ZIP+4).

include_traceboolean

Response

Successful Response

statusstring
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.