empty_address
Nothing in the request was an address
Neither the written address nor the separated fields carried anything the parser could recognise, so there was nothing to check.
- appears in
- reason
- credits
- Free. An address that cannot stand as written never costs a credit.
What it means
An address is empty when none of organization, street, house number, PO box, locality, administrative area or postal code came out of the input: a blank string, a value of punctuation and whitespace, or fields that were all empty.
Nothing else runs. The country is echoed back, every other field is null, and no risk score is computed.
What to do
Check that the field you send is the one the user filled in. A single written address goes in `address`; separated fields go in `address_line1` and its siblings.
Example response
{
"valid": false,
"reason": "empty_address",
"country": "GB",
"formatted": null,
"risk_score": null
}Abbreviated: a real answer carries all 33 fields, listed in the validate-phone reference.
Related
- unknown_country · no postal format is published for that country
- missing_street · the country requires a street line and none was found
- missing_locality · a country with no postcode to name the town was given neither
- missing_administrative_area · a country with no postcodes needs the state or province
- missing_postal_code · the country requires a postcode and none was given
- invalid_postal_code · the postcode is not the shape that country uses
- postcode_not_found · the postcode is well formed but is not in the directory
- All verdict reasons
- Phone fields and the risk score
- API reference
markdown version: /docs/reasons/empty_address.md