missing_street
The country requires a street line and none was found
The operator treats the street line as mandatory, and neither a street nor a delivery point that stands in for one (a box, a rural route, general delivery) was recognised in the address.
- appears in
- reason
- credits
- Free. An address that cannot stand as written never costs a credit.
What it means
Almost every country requires a first address line. A postcode and a town alone reach a place, not a door, so the address cannot be delivered as written.
A post-office box, a rural route or a general-delivery line stands in for the street line, which is exactly what the operator intends, so none of those answers this reason. What does is an address that carries only geography: "94043", or "Springfield, IL 62701", whose lone line before the state and ZIP is read as the town.
A lone line with no number can be a town or a street, and its shape does not always say which, so the installed data decides where it can. A place the postcode directory lists for the code, or elsewhere in its area, makes the line the town, so "Mountain View, CA 94043" answers this reason with Mountain View as the town. A street a register's street listing files under the postcode (in Great Britain, under its district) makes the line the street, so "Strand, WC2R 0RL" is a valid street address, confirmed by the register. Where the data says both or neither, the shape decides: a line that ends in a street type is read as the street, and one that does not as the town. That is why "London Wall, EC2M 5QD" answers this reason, because Open Names files London Wall under EC2Y. Send the separated fields when you hold them apart.
What to do
Send the street line in `address_line1`, or the whole address in `address`. If your form collects the house number separately, write it into the same line in the order that country uses.
Example response
{
"valid": false,
"reason": "missing_street",
"country": "US",
"street": null,
"postal_code": "94043",
"risk_score": null
}Abbreviated: a real answer carries every field, listed in the validate-phone reference.
Related
- empty_address · nothing in the request was an address
- unknown_country · no postal format is published for that country
- 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/missing_street.md