Overview
Geocode up to 1000 US addresses in a single call. Flat $0.001 per batch — much cheaper per address at scale than the single-address endpoint. JSON body: an array of { id, street, city?, state?, zip? } objects, or { addresses: [...] }. Response is an object map keyed by the user-provided 'id' so results can be joined back to inputs.
Protocol
x402
Price
$0.0010
Payment Asset
USD Coin
Payment Network
Base
Category
uncategorized
Provider
x402-geocoder-production
Indexed
2026-04-30 14:54:39
Health
Status
degraded
Latency (p50)
216ms
Uptime (30d)
100.0%
Reliability Score
95/100
Last Checked
2026-07-02 00:52:36
Last Healthy
Never
Consecutive Failures
0
Input Schema
{
"bodyFields": {
"addresses": [
{
"city": "Washington",
"id": "wh",
"state": "DC",
"street": "1600 Pennsylvania Ave NW"
}
]
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
}
Output Schema
{
"additionalProperties": {
"properties": {
"address": {
"description": "Census-canonical full address string",
"type": [
"string",
"null"
]
},
"fips": {
"description": "US Census FIPS codes for the matched location, or null if no match.",
"properties": {
"block": {
"description": "4-digit census block code",
"type": "string"
},
"county": {
"description": "3-digit county FIPS code",
"type": "string"
},
"state": {
"description": "2-digit state FIPS code",
"type": "string"
},
"tract": {
"description": "6-digit census tract code",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"lat": {
"description": "Latitude in decimal degrees",
"type": [
"number",
"null"
]
},
"lng": {
"description": "Longitude in decimal degrees",
"type": [
"number",
"null"
]
},
"match": {
"description": "true if Census matched the address",
"type": "boolean"
},
"matchType": {
"description": "Census match quality",
"enum": [
"Exact",
"Non_Exact",
null
],
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"description": "Object map keyed by the user-provided 'id' from each input address. Each value matches the /geocode/address response shape.",
"type": "object"
}