# SameDayDesk Contract-Qualified Search

> SameDayDesk Contract-Qualified Search is a paid API for AI agents from agents.samedaydesk.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Discovers and pre-qualifies machine-payable API endpoints that guarantee specific JSON response paths, returning only services an agent can autonomously buy and use.

## Facts

- Endpoint: GET https://agents.samedaydesk.com/commerce/contract-qualified-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/samedaydesk-contract-qualified-search-3552057e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BFDwuCfBwccFFDassqUYR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability samedaydesk-contract-qualified-search-3552057e
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/samedaydesk-contract-qualified-search-3552057e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.samedaydesk.com](https://www.zero.xyz/host/agents.samedaydesk.com/llms.txt)