{"uid":"cap_I-_zjk7GXfLg4PU46wTaN","slug":"x402-geocoder-batch-e6b71bc4","name":"x402 Geocoder Batch","description":"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.","url":"https://x402-geocoder-production.up.railway.app/geocode/batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DqldzHjZXIVyQq8as4emY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geocodes up to 1000 US addresses in a single call, returning lat/lng and US Census FIPS codes for each, keyed by user-provided ID.","exampleAgentPrompt":"I have a list of 800 US customer addresses — can you geocode all of them in one shot and give me back their lat/lng coordinates keyed by the customer ID I provide?","exampleUseCases":[{"title":"Customer database location enrichment","prompt":"I have a spreadsheet of 600 customer records with street, city, and state — can you geocode all of them at once and return lat/lng for each, matched back to their customer ID?"},{"title":"Delivery route coordinate preparation","prompt":"I need to geocode these 300 delivery stop addresses before running them through a routing engine — can you batch resolve them all to coordinates in one call, keyed by stop ID?"},{"title":"Census FIPS mapping for research dataset","prompt":"I have a research dataset of 950 US addresses and I need the Census tract and block FIPS codes for each one — can you geocode the whole list at once and give me back the results by record ID?"}],"resultDescription":"A JSON object map keyed by the user-provided 'id' for each input address. Each value contains the resolved latitude, longitude, and US Census FIPS codes (state, county, tract, block) for that address. Addresses that could not be resolved may be absent or flagged in the response.","failureModes":["Batch exceeds 1000 addresses — request rejected","Malformed address objects missing required 'id' or 'street' fields — validation error","Unresolvable or ambiguous addresses — those IDs may be missing or null in the response","Payment failure or insufficient USDC balance — 402 response before processing","Network timeout for very large batches near the 1000-address limit"],"whenToPreferThis":"Use this endpoint when you need to geocode more than one US address at a time and want cost efficiency — at $0.001 per address (flat $0.50 per batch for up to 1000), it is far cheaper per address than the single-address endpoint. Ideal for enriching datasets, preparing delivery manifests, or any workflow where you have tens to hundreds of addresses to resolve in one shot. Prefer the single-address sibling endpoint for one-off lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T18:35:49.473Z","isFirstParty":false,"canonicalSlug":"x402-geocoder-batch-e6b71bc4"}