{"definitionRoot":"0727d6197d2f4861d849f44834d3a4c009a9887846564561ac81f0ce053d0ade","docsPath":"/docs/ADDRESS_GEOCODE_BATCH.json","errors":[{"code":null,"description":"The request field is invalid.","status":400},{"code":null,"description":"Payment Required - an x402 v2 offer in the PAYMENT-REQUIRED header and body.","status":402},{"code":null,"description":"The result could not be delivered.","status":422},{"code":null,"description":"The seller or the product quote path is not currently admitting this request.","status":503}],"examples":{"deliverable":null,"detail":"Concrete request/deliverable examples are omitted until real settled evidence supplies them; the no-fake-demand rule forbids inventing sample payloads. The envelope shapes above are exact.","request":null,"state":"OMITTED_UNTIL_REAL_EVIDENCE"},"family":"UTILITY","familyTitle":"Utility","freshness":{"evidenceCutoff":"Every delivered envelope states its own evidenceCutoff; requests may pin evidenceCutoff at or before quote time.","freshnessClass":"CACHEABLE_SNAPSHOT","latencyClass":"STANDARD","machineVersion":"df8b5c0c","outputDomainKind":null,"provenance":"The deliverable carries its own uncertainty statement; citations are opaque content hashes for the public evidence used."},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"addresses":{"description":"A JSON array of 1 to 10 US street addresses, each one line with a house number and street name, e.g. [\"4600 Silver Hill Rd, Washington, DC 20233\", \"101 Independence Ave SE, Washington, DC 20540\"]. Each follows the single-address rules (5-200 characters of letters, digits, spaces and , . # ' & / -); one bad entry refuses the order without charge. Results come back in the same order.","items":{},"type":"array"}},"required":["addresses"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"method":"POST","operationId":"agenthubmachineaddress_geocode_batch","outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"citations":{"description":"Content hashes of Arbiter's archived official-record readings this deliverable was rendered from.","items":{},"type":"array"},"observedAt":{"description":"ISO-8601 instant of the newest official read behind this deliverable.","type":"string"},"program":{"description":"Program identity: {id, version, programRoot, registryRoot}.","type":"object"},"record":{"description":"Batch geocode: {benchmark {name, id}, addressCount, matchedCount, results[] (the buyer's order, one per address, at most 10)}; each result is {index, address (normalized, as sent to the Census Bureau), status: MATCHED|NO_MATCH|INPUT_REFUSED_BY_CENSUS, matchType: MATCH|TIE|NO_MATCH|null, matchCount, best} and best is {matchedAddress, longitude, latitude, tigerLine {tigerLineId, side: L|R}, components {fromAddress, toAddress, preQualifier, preDirection, preType, streetName, suffixType, suffixDirection, suffixQualifier, city, state, zip}} or null. Text fields are {status: OK, value} or {status: WITHHELD_UNSAFE_TEXT, rawSha256}.","type":"object"},"source":{"description":"Attribution: {publisher, endpoints[], retrievedAt, rightsBasis: US_FEDERAL_PUBLIC_RECORD_SELF_OBSERVED, endorsement: NONE, notice: \"This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.\"}.","type":"object"},"subject":{"description":"What was looked up: {kind: CENSUS_ADDRESS, address} (the normalized address sent to the Census Bureau), {kind: CENSUS_ADDRESS_LIST, addresses[]} (normalized, in the buyer's order) or {kind: CENSUS_POINT, latitude, longitude} (six decimal places).","type":"object"},"uncertainty":{"description":"Plain-language limits of this record.","type":"string"}},"required":["program","subject","record","source","citations","observedAt","uncertainty"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"payment":{"admitted":true,"challengeHeader":"PAYMENT-REQUIRED","destination":{"address":"0x63aA5960943865e7d57FDdF0D899eE36B6D2046E","assetContracts":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85","0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392","0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","0x754704Bc059F8C67012fEd69BC8A327a5aafb603","0xaf88d065e77c8cC2239327C5EDb3A432268e5831","0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E","0x3600000000000000000000000000000000000000","0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"bindingVersion":"a2f250e514c4a05c34efc98c49a4f4ac01a67770884883d19ff3a6487972ed90","networks":["eip155:1","eip155:10","eip155:1329","eip155:137","eip155:143","eip155:42161","eip155:43114","eip155:5042","eip155:8453"],"resolvable":true,"source":"x402_seller_configuration.payTo"},"logicalPaymentHeader":"ARBITER-LOGICAL-PAYMENT-ID","payToSource":"the canonical RevenueWalletResolver binding (x402_seller_configuration.payTo); never an environment value and never a literal","paymentIdentifier":{"extension":"payment-identifier","semantics":"Retries carrying the same payment identifier return the cached delivery with the same receipt: no second settlement, no second work, no second delivery credit.","supported":true},"processingSemantics":"A 202 means verification or settlement is still in progress; retry the same call with the same payment and the same payment identifier.","protocol":"X402_V2","protocolVersion":2,"quoteHeader":"ARBITER-QUOTE-ID","scheme":"exact","signatureHeader":"PAYMENT-SIGNATURE"},"pricing":{"currency":"USD","floorUsd":0.012,"mode":"DYNAMIC_QUOTE","ownerCeilingUsd":null,"pricingClass":"CACHEABLE_UNIT","publicStartingPriceUsd":0.012},"productId":"ADDRESS_GEOCODE_BATCH","productVersion":"1.0.0","provenance":{"basis":"PUBLIC_RECORD","protocols":[],"sources":["US Census Bureau Geocoder"]},"resourceUrl":"https://arbiterverse.com/api/x402/ADDRESS_GEOCODE_BATCH","schemaVersion":"1.0.0","summary":"Up to 10 US street addresses in one call and one settlement, each matched by the US Census Bureau Geocoder: coordinates, standardized address, TIGER line and side, match type, in your order. This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau. Completion budget: 30 s p95, 180 s at most from payment to the record, plus the chain's settlement time; while the Census Geocoder is unavailable Arbiter refuses the quote instead of taking payment. Coordinates are interpolated along each street's address range. Example request: {\"addresses\":[\"4600 Silver Hill Rd, Washington, DC 20233\",\"101 Independence Ave SE, Washington, DC 20540\"]}.","title":"US address geocode, batch of up to 10"}