{"slug":"http-forest-gas-station-mainnet-lcjl27p8lmjs-code-run-dns-pr-5bf79e","title":"Check whether a DNS change has reached the configured public resolvers","host":"http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run","method":"POST","resource":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/dns/propagation","category":"code","description":"Check whether a DNS change has reached the configured public resolvers. Compare public DoH answers with an optional expected answer set and return complete, partial, not_observed or unknown. Scope is a fixed bounded resolver set; Forest does not claim worldwide propagation. Base mainnet USDC","price_listed":0.003,"price_asked":0.003,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":911,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"expected_answers":["93.184.216.34"],"hostname":"example.com","record_type":"A"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"expected_answers":{"description":"Public expected answers value used to scope this lookup.","items":{"maxLength":512,"minLength":1,"type":"string"},"maxItems":32,"minItems":1,"type":"array"},"hostname":{"description":"Public hostname value used to scope this lookup.","maxLength":253,"pattern":"^[a-zA-Z0-9.-]+$","type":"string"},"record_type":{"description":"Public record type value used to scope this lookup.","enum":["A","AAAA","CNAME","MX","NS","TXT"]}},"required":["hostname","record_type"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"capability":{"const":"dns.propagation","description":"Public capability value used to scope this lookup."},"data":{"additionalProperties":false,"description":"Public data value used to scope this lookup.","properties":{"answer_sets":{"description":"Public answer sets value used to scope this lookup.","items":{"additionalProperties":false,"properties":{"answers":{"description":"Public answers value used to scope this lookup.","items":{"type":"string"},"type":"array"},"rcode":{"description":"Public rcode value used to scope this lookup.","type":"string"},"resolvers":{"description":"Public resolvers value used to scope this lookup.","items":{"type":"string"},"type":"array"}},"required":["rcode","answers","resolvers"],"type":"object"},"type":"array"},"consensus_state":{"description":"Public consensus state value used to scope this lookup.","enum":["agreement","disagreement","insufficient_data","unknown"]},"expected_answers":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Public expected answers value used to scope this lookup."},"failed_resolvers":{"description":"Public failed resolvers value used to scope this lookup.","maximum":3,"minimum":0,"type":"integer"},"hostname":{"description":"Public hostname value used to scope this lookup.","type":"string"},"matching_resolvers":{"description":"Public matching resolvers value used to scope this lookup.","maximum":3,"minimum":0,"type":"integer"},"record_type":{"description":"Public record type value used to scope this lookup.","type":"string"},"resolver_count":{"description":"Public resolver count value used to scope this lookup.","maximum":3,"minimum":1,"type":"integer"},"resolvers":{"description":"Public resolvers value used to scope this lookup.","items":{"additionalProperties":false,"properties":{"answers":{"description":"Public answers value used to scope this lookup.","items":{"type":"string"},"type":"array"},"rcode":{"description":"Public rcode value used to scope this lookup.","type":["string","null"]},"resolver":{"description":"Public resolver value used to scope this lookup.","type":"string"},"state":{"description":"Public state value used to scope this lookup.","enum":["ok","error"]},"ttl_max":{"description":"Public ttl min value used to scope this lookup.","type":["integer","null"]},"ttl_min":{"description":"Public ttl min value used to scope this lookup.","type":["integer","null"]}},"required":["resolver","state","rcode","answers","ttl_min","ttl_max"],"type":"object"},"type":"array"},"scope":{"const":"bounded_public_doh_resolvers_only","description":"Public scope value used to scope this lookup."},"state":{"description":"Public state value used to scope this lookup.","enum":["complete","partial","not_observed","unknown"]},"successful_resolvers":{"description":"Public successful resolvers value used to scope this lookup.","maximum":3,"minimum":0,"type":"integer"}},"required":["hostname","record_type","resolver_count","successful_resolvers","failed_resolvers","answer_sets","resolvers","state","consensus_state","expected_answers","matching_resolvers","scope"],"type":"object"},"meta":{"additionalProperties":false,"description":"Public meta value used to scope this lookup.","properties":{"cache":{"description":"Public cache value used to scope this lookup.","enum":["hit","miss","bypass"]},"checked_at":{"description":"Public checked at value used to scope this lookup.","type":"string"},"duration_ms":{"description":"Public duration ms value used to scope this lookup.","minimum":0,"type":"integer"},"provider":{"description":"Public provider value used to scope this lookup.","type":["string","null"]}},"required":["provider","checked_at","cache","duration_ms"],"type":"object"},"ok":{"const":true,"description":"Public ok value used to scope this lookup."},"version":{"const":"1","description":"Package version whose public metadata should be checked."}},"required":["ok","capability","version","data","meta"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.003,"price_match":true,"latency_ms":911,"error":null}],"description_full":"Check whether a DNS change has reached the configured public resolvers. Compare public DoH answers with an optional expected answer set and return complete, partial, not_observed or unknown. Scope is a fixed bounded resolver set; Forest does not claim worldwide propagation. Base mainnet USDC","last_updated":"2026-10-09T00:21:07.617Z","schemes":["exact"]}