{"uid":"cap_BFDwuCfBwccFFDassqUYR","slug":"samedaydesk-contract-qualified-search-3552057e","name":"SameDayDesk Contract-Qualified Search","description":"Deterministic agent APIs for web and company intelligence, repository security, agent-work economics, machine-service discoverability, payment preflight and settlement proof, wallet context, and Morpho decision evidence. Pay per call through Base x402 or native MPP, with a Circle Gateway Nanopayments path for gasless batched USDC.","url":"https://agents.samedaydesk.com/commerce/contract-qualified-search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query","requiredPaths"],"properties":{"limit":{"type":"integer","default":5,"maximum":8,"minimum":1,"description":"Maximum total candidates audited across Agent402 and MPP."},"query":{"type":"string","maxLength":300,"minLength":10,"description":"Capability intent sent to Agent402 search and used locally to rank MPP catalog metadata. Do not include secrets."},"requiredPaths":{"type":"string","pattern":"^[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+){0,7}(?:,[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+){0,7}){0,15}$","description":"Buyer-required dotted JSON paths every returned seller schema must guarantee recursively."},"maxPriceDisplayUnits":{"type":"number","default":0.1,"maximum":10,"description":"Maximum advertised per-call price in each source's display currency.","exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","product","version","checkedAt","decision","request","sources","qualified","rejected","boundary"],"properties":{"ok":{"type":"boolean","const":true},"product":{"type":"string","const":"samedaydesk-contract-qualified-search"},"request":{"type":"object","required":["queryDigest","requiredPaths","maxPriceDisplayUnits","limit"],"properties":{"limit":{"type":"integer"},"queryDigest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"requiredPaths":{"type":"array","items":{"type":"string"},"maxItems":16,"minItems":1},"maxPriceDisplayUnits":{"type":"number"}},"additionalProperties":false},"sources":{"type":"object","required":["agent402","mpp"],"properties":{"mpp":{"type":"object","required":["status","discovered","audited"],"properties":{"status":{"enum":["ok","unavailable"],"type":"string"},"audited":{"type":"integer"},"discovered":{"type":"integer"}},"additionalProperties":false},"agent402":{"type":"object","required":["status","discovered","audited"],"properties":{"status":{"enum":["ok","unavailable"],"type":"string"},"audited":{"type":"integer"},"discovered":{"type":"integer"}},"additionalProperties":false}},"additionalProperties":false},"version":{"type":"string","const":"1.1.0"},"boundary":{"type":"object","required":["credentialsUsed","walletAccessed","targetPaymentSigned","targetPaymentSent","sellerPostRequestSent","paidResponseBodyRead","queryRetained","querySentTo","directoryRequests","sellerAudits"],"properties":{"querySentTo":{"type":"array","items":{"enum":["agent402"],"type":"string"}},"sellerAudits":{"type":"integer"},"queryRetained":{"type":"boolean","const":false},"walletAccessed":{"type":"boolean","const":false},"credentialsUsed":{"type":"boolean","const":false},"directoryRequests":{"type":"integer"},"targetPaymentSent":{"type":"boolean","const":false},"targetPaymentSigned":{"type":"boolean","const":false},"paidResponseBodyRead":{"type":"boolean","const":false},"sellerPostRequestSent":{"type":"boolean","const":false}},"additionalProperties":false},"decision":{"enum":["qualified_candidates_found","no_qualified_candidate"],"type":"string"},"rejected":{"type":"array","items":{"type":"object","required":["source","serviceName","origin","method","route","price","reason","findings"],"properties":{"price":{"type":"object","required":["amountDisplayUnits","currency","decimals","amountAtomic"],"properties":{"currency":{"type":"string"},"decimals":{"type":"integer"},"amountAtomic":{"type":"string"},"amountDisplayUnits":{"type":"number"}},"additionalProperties":false},"route":{"type":"string"},"method":{"enum":["GET","POST"],"type":"string"},"origin":{"type":"string","format":"uri"},"reason":{"type":"string"},"source":{"enum":["agent402","mpp"],"type":"string"},"findings":{"type":"array","items":{"type":"string"},"maxItems":12},"serviceName":{"type":"string"}},"additionalProperties":false},"maxItems":8},"checkedAt":{"type":"string","format":"date-time"},"qualified":{"type":"array","items":{"type":"object","required":["source","serviceName","origin","method","route","price","description","decision","protocols","runtimeChallengeVerified","guaranteedPaths"],"properties":{"price":{"type":"object","required":["amountDisplayUnits","currency","decimals","amountAtomic"],"properties":{"currency":{"type":"string"},"decimals":{"type":"integer"},"amountAtomic":{"type":"string"},"amountDisplayUnits":{"type":"number"}},"additionalProperties":false},"route":{"type":"string"},"method":{"enum":["GET","POST"],"type":"string"},"origin":{"type":"string","format":"uri"},"source":{"enum":["agent402","mpp"],"type":"string"},"decision":{"enum":["machine_buyable","contract_ready"],"type":"string"},"protocols":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"serviceName":{"type":"string"},"guaranteedPaths":{"type":"array","items":{"type":"string"},"maxItems":16},"runtimeChallengeVerified":{"type":"boolean"}},"additionalProperties":false},"maxItems":8}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"ok":true,"product":"samedaydesk-contract-qualified-search","request":{"limit":5,"queryDigest":"sha256:64f12b41f9a391176291881e042659376376348e5373e18a3b1bf9557caa411c","requiredPaths":["data.sourceRepository"],"maxPriceDisplayUnits":0.1},"sources":{"mpp":{"status":"ok","audited":1,"discovered":2},"agent402":{"status":"ok","audited":2,"discovered":3}},"version":"1.1.0","boundary":{"querySentTo":["agent402"],"sellerAudits":3,"queryRetained":false,"walletAccessed":false,"credentialsUsed":false,"directoryRequests":2,"targetPaymentSent":false,"targetPaymentSigned":false,"paidResponseBodyRead":false,"sellerPostRequestSent":false},"decision":"qualified_candidates_found","rejected":[],"checkedAt":"2026-08-12T12:00:00.000Z","qualified":[{"price":{"currency":"USD","decimals":6,"amountAtomic":"10000","amountDisplayUnits":0.01},"route":"/source-proof","method":"GET","origin":"https://service.example","source":"agent402","decision":"machine_buyable","protocols":["x402"],"description":"Return source repository provenance for a public service.","serviceName":"Example source proof","guaranteedPaths":["data.sourceRepository"],"runtimeChallengeVerified":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LyVYBmOZ3Ry0Jz-eNFoHq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Discovers and pre-qualifies machine-payable API endpoints that guarantee specific JSON response paths, returning only services an agent can autonomously buy and use.","exampleAgentPrompt":"Search for machine-payable APIs that guarantee a 'data.sourceRepository' field in their response, cap the price at $0.10 per call, and return up to 5 qualified candidates — I need my agent to autonomously buy one to get source repository provenance.","exampleUseCases":[{"title":"Autonomous repository provenance lookup","prompt":"Find me up to 3 agent-callable APIs that guarantee a 'data.sourceRepository' field in their JSON response and cost no more than $0.05 each — my agent needs to autonomously buy one to verify where a public service's code lives."},{"title":"Budget-capped company intelligence sourcing","prompt":"Search for machine-payable services that return company intelligence data, guarantee 'data.companyName' in the response, limit results to 5, and only show me options under $0.10 per call so my agent can pick and pay for one automatically."},{"title":"Pre-flight endpoint qualification for agent pipeline","prompt":"Before my agent commits to calling any paid API for web intelligence, can you search for qualified candidates that guarantee 'data.domain' in their output, are x402-compatible, and cost less than $0.02 per call — show up to 10 options."}],"resultDescription":"A JSON object containing a list of qualified endpoints that passed the audit, each with price details, HTTP route, origin URL, supported payment protocols, guaranteed response paths, a machine-buyable decision label, and a boundary telemetry block showing what actions were and were not taken during discovery (e.g. whether credentials were used or payments were sent). Also includes rejected endpoints and overall discovery statistics from MPP and agent402 sources.","failureModes":["No endpoints found that guarantee the required JSON paths — decision returns no qualified candidates","All discovered endpoints exceed the maxPriceDisplayUnits ceiling and are rejected","Query digest matches no indexed services in MPP or agent402 directories","Malformed requiredPaths expressions cause validation errors","Rate limiting or payment failure prevents the search itself from executing","Source directories (MPP, agent402) temporarily unavailable, returning partial results"],"whenToPreferThis":"Use this endpoint when an AI agent needs to autonomously discover and pre-qualify third-party paid APIs before committing to purchase them — especially when the agent requires a guaranteed JSON schema contract (specific response paths must exist), a hard price ceiling, and audit evidence that the endpoint is legitimately machine-buyable. Prefer this over generic API directories when the agent must make autonomous payment decisions without human review, or when you need boundary telemetry proving no credentials or payments were used during discovery itself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:52:37.786Z","isFirstParty":false}