{"definitionRoot":"e528b576d60234462b20e4a49b16787100d6a0b3d4fd02df0e2ebcbbfdf2d896","docsPath":"/docs/ADDRESS_GEOCODE.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":{"address":{"description":"One US street address on one line, with a house number and street name, ideally with city, state and ZIP, e.g. \"4600 Silver Hill Rd, Washington, DC 20233\". 5-200 characters of letters, digits, spaces and , . # ' & / -; an empty, oversized or garbage address is refused without charge. Spacing and case are normalized before lookup.","type":"string"}},"required":["address"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"method":"POST","operationId":"agenthubmachineaddress_geocode","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":"Address geocode: {status: MATCHED|NO_MATCH|INPUT_REFUSED_BY_CENSUS, matchType: MATCH (one candidate)|TIE (several)|NO_MATCH, matchCount, benchmark {name, id}, best, candidates[] (Census order, at most 5)}; each candidate is {matchedAddress, longitude, latitude, tigerLine {tigerLineId, side: L|R}, components {fromAddress, toAddress, preQualifier, preDirection, preType, streetName, suffixType, suffixDirection, suffixQualifier, city, state, zip}}; best is the first candidate 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.0012,"mode":"DYNAMIC_QUOTE","ownerCeilingUsd":null,"pricingClass":"CACHEABLE_UNIT","publicStartingPriceUsd":0.0012},"productId":"ADDRESS_GEOCODE","productVersion":"1.0.0","provenance":{"basis":"PUBLIC_RECORD","protocols":[],"sources":["US Census Bureau Geocoder"]},"resourceUrl":"https://arbiterverse.com/api/x402/ADDRESS_GEOCODE","schemaVersion":"1.0.0","summary":"One US street address to its US Census Bureau match: coordinates, standardized address, TIGER line id and side of the street, and match type (MATCH, TIE or NO_MATCH). This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau. Completion budget: 20 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. Read from the Census Geocoder (benchmark Public_AR_Current) after payment and cited to Arbiter's archived copy; coordinates are interpolated along the street's address range. Example request: {\"address\":\"4600 Silver Hill Rd, Washington, DC 20233\"}.","title":"US address geocode"}