{"uid":"cap_-FPR24Zi_S2k_JB9FOZmT","slug":"nohumans-directory-listing-verdict-9b611b78","name":"nohumans.directory Listing Verdict","description":"nohumans.directory pre-spend verdict for one listing: probe history, payTo age and stability, paid-delivery outcome, verified verb, and a pay/caution/avoid verdict with reasons.","url":"https://api.nohumans.directory/v1/listings/:id/verdict","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","properties":{"queryParams":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"object","properties":{"status":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"verdict":{"enum":["pay","caution","avoid"],"type":"string"},"listing_id":{"type":"string"},"verified_via":{"type":["string","null"]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9LKuElL7QP6hktm0UjLG2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a pre-spend trust verdict (pay/caution/avoid) for a specific x402 API listing based on probe history, payTo age/stability, and paid-delivery outcomes.","exampleAgentPrompt":"Before I call that x402 API, check the nohumans.directory verdict for listing ID abc123 — I want to know if it's safe to pay for, or if I should avoid it.","exampleUseCases":[{"title":"Pre-spend check before API call","prompt":"I'm about to pay $0.01 to call listing xyz789 on nohumans.directory — can you pull the verdict first and tell me if it says pay, caution, or avoid?"},{"title":"Automated agent trust gate","prompt":"Before my agent spends any money on listing def456, get its nohumans.directory verdict and only proceed if the verdict is 'pay' — otherwise show me the reasons to avoid it."},{"title":"Evaluating a new data API source","prompt":"I found a paid API listing with ID ghi321 that claims to deliver stock data — can you check the nohumans.directory verdict to see how it scores on probe history and paid-delivery reliability?"}],"resultDescription":"Returns a JSON object with a 'verdict' field ('pay', 'caution', or 'avoid'), a 'status' string, a 'listing_id', an optional 'verified_via' field indicating verification method, and a 'reasons' array explaining the recommendation based on probe history, payTo address age and stability, and paid-delivery outcomes.","failureModes":["Listing ID not found — returns error if the provided ID does not correspond to a known listing","Insufficient probe history — verdict may return 'caution' with limited data","Stale or unverified listing — verified_via may be null if automated verification has not completed","Network timeout — fast endpoint but may fail transiently under load","Invalid ID format — malformed listing ID causes bad request error"],"whenToPreferThis":"Use this endpoint when an AI agent is about to make a paid x402 API call and needs a pre-spend trust signal to decide whether to proceed. It is specifically designed for agentic workflows that need automated go/no-go decisions on paid API listings in the nohumans.directory ecosystem, based on empirical probe history rather than self-reported metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:24.540Z","isFirstParty":false}