Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Path Parameters

id
string
required

Address identity identifier

Body

application/json

Input for identifying a specific address identity

agentId
required

Agent identifier that owns this address

Pattern: ^[0-9a-z]+$

Response

200 - application/json

OK

Address validation result. Validation is structural/format-only (provider anima_lite): it normalizes the country code and US state, and checks field shapes — it does not verify the address exists or is deliverable.

valid
boolean
required

Whether the address passed structural (format-only) validation: ISO 3166-1 alpha-2 country, US state code + ZIP shape for US addresses, non-empty street/city. This is NOT a deliverability or postal-database check.

standardized
object
required

Standardized version of the address

confidence
number
required

Confidence score between 0 and 1

Required range: 0 <= x <= 1
suggestions
object[]
required

Reserved: alternative address suggestions. Currently ALWAYS an empty array — the built-in validator is structural only (provider anima_lite) and does not generate alternatives. Populated only if/when a postal-data provider is integrated.