# LUMEN B2B Supplier Snapshot

> LUMEN B2B Supplier Snapshot is a paid API for AI agents from lumen-zero-x402.lumen-b2b.workers.dev, paid per call via x402, $1/call, status unknown (last checked 2026-10-12).

Returns a supplier snapshot report for a given sourcing brief, researching B2B suppliers and procurement options on demand

## Facts

- Endpoint: GET https://lumen-zero-x402.lumen-b2b.workers.dev/buy/supplier-snapshot?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumen-b2b-supplier-snapshot-ebec8c9f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_srjOl_9D_vAevSScwjRj3

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 lumen-b2b-supplier-snapshot-ebec8c9f
```

Example prompt: I need a supplier snapshot for industrial-grade stainless steel fasteners — we're looking for manufacturers who can handle mid-volume orders with ISO certification; here's our brief: we source M6 hex bolts in quantities of 50,000 units quarterly and need suppliers with verified quality certifications and North American distribution.

## When to prefer this

Choose this endpoint when you need a real B2B supplier research snapshot for a specific procurement requirement and are willing to pay $1 USDC per lookup via x402 on Base mainnet. Best suited for sourcing teams, procurement agents, or supply chain workflows that need curated supplier intelligence rather than a generic web search. Note that results require human approval by LUMEN before delivery, making this unsuitable for fully autonomous or time-critical workflows.

## Known failure modes

- Sourcing brief too short (under 12 characters) or too long (over 1200 characters) returns a validation error
- Payment not settled on Base mainnet results in request not being processed
- Human approval not yet granted means results are pending and not immediately available
- Invalid query parameters or missing required fields return a 400-level error
- Network or worker availability issues on Cloudflare Workers may cause timeouts

## How this service works

Real B2B sourcing and procurement research. Seven paid endpoints on Base mainnet. Payment settlement requires individual human approval by LUMEN. No autonomous purchases.

## Output

Returns a structured supplier snapshot including a receipt ID, product ID, payment authorization confirmation, status of the research request, and next action instructions. The actual supplier research data is queued and delivered after LUMEN's human approval of the payment settlement.

## 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": [],
     "properties": {
      "requirement": {
       "type": "string",
       "maxLength": 1200,
       "minLength": 12,
       "description": "Nonconfidential sourcing brief; 12-1200 characters; queued only after a verified settlement."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "productId",
      "amountUsd"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "status": {
       "type": "string"
      },
      "amountUsd": {
       "type": "number"
      },
      "productId": {
       "type": "string"
      },
      "receiptId": {
       "type": "string"
      },
      "nextAction": {
       "type": "string"
      },
      "paymentAuthorizationVerified": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumen-b2b-supplier-snapshot-ebec8c9f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lumen-zero-x402.lumen-b2b.workers.dev](https://www.zero.xyz/host/lumen-zero-x402.lumen-b2b.workers.dev/llms.txt)