POST/v1/zips/verify
Validate one zip or a batch; returns a valid flag + the canonical record for each.
[ OPTIONS ]
| Name | Type | Required | Description |
|---|---|---|---|
zip | string (body) | No | A single zip to verify. Use this or zips[]. |
zips | string[] (body) | No | Up to 100 zips to verify in one call. |
[ EXAMPLE REQUEST ]
curl -X POST "https://atlasblock.dev/api/v1/zips/verify" \ -H "Content-Type: application/json" \ -d '{"zips":["28203","00000"]}'
[ 200 OK ]
{
"status": "success",
"data": {
"count": 2,
"results": [
{
"query": "28203",
"zip": "28203",
"valid": true,
"location": {
"zip": "28203",
"city": "Charlotte",
"state": "NC",
"county_fips": "37119"
}
},
{
"query": "00000",
"zip": "00000",
"valid": false,
"location": null
}
]
}
}[ TRY IT ]Open playground →
POST/v1/zips/verify
[ BODY · JSON ]
zip· string (body) — A single zip to verify. Use this or zips[].zips· string[] (body) — Up to 100 zips to verify in one call.
[ CURL ]
curl -X POST "https://atlasblock.dev/api/v1/zips/verify" \ -H "Authorization: Bearer $ATLASBLOCK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zips":["28203","00000"]}'
[ EVERY REQUEST ]
Send an Authorization: Bearer key against the base URL https://atlasblock.dev/api. Every call counts toward your plan quota. See the overview for authentication, rate limits, and status codes.