ShelvesNI BIASHARA
data · instant load-vet-pack

Load vet pack — authority + BASICs + broker + OFAC name

Pre-tender check: FMCSA authority and SMS BASICs (monthly) for the carrier, broker authority for broker_mc, optional OFAC name screen. TENDER/HOLD/REJECT from public fields only, no fraud score. A section that times out returns status "timeout" with partial:true and a HOLD verdict; full price applies when carrier authority (broker, for a broker-only pack) is delivered.

$0.08 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.

Parameters

paramdescription
dotcarrier USDOT number (optional; give dot, mc or broker_mc)
mccarrier MC/docket number (optional; give dot, mc or broker_mc)
broker_mcbroker MC/docket number — runs the FMCSA broker-authority check (optional)
namelegal name to OFAC-screen (optional)

Call it (any x402 client)

# 1. GET without payment → HTTP 402 with PAYMENT-REQUIRED (price, payTo, scheme "exact")
curl -i "https://agents.nibiashara.biz/shelf/load-vet-pack?dot=44110&mc=515000&broker_mc=384859&name=Example%20Trading%20Co"

# 2. Sign the payment (EIP-3009 transferWithAuthorization, gasless) and retry
#    with the PAYMENT-SIGNATURE header → response body is the delivery.

With the official JS client the whole flow is one wrapped fetch:

import { wrapFetchWithPayment } from "@x402/fetch";       // npm i @x402/fetch @x402/evm
const fetchPaid = wrapFetchWithPayment(fetch, { /* your EVM signer */ });
const res = await fetchPaid("https://agents.nibiashara.biz/shelf/load-vet-pack?dot=44110&mc=515000&broker_mc=384859&name=Example%20Trading%20Co");
const data = await res.json();

Or install the MCP server (https://agents.nibiashara.biz/mcp, registry id biz.nibiashara/shelves) and use the job-named tool for this shelf, or buy_shelf as an escape hatch.

Google Cloud Marketplace subscriber? Send your access key instead of paying: curl -H "X-SHELF-PASS: $SHELVES_KEY" "https://nibiashara-shelves-626103352898.us-central1.run.app/shelf/load-vet-pack?dot=44110&mc=515000&broker_mc=384859&name=Example%20Trading%20Co". On that host this check spends 25 credits. Plans and credit costs.
Calling this repeatedly? Buy a Shelf Pass once ($0.99 for 110 credits) and send X-SHELF-PASS: <token> instead of paying per call — this shelf costs 8 credits per call.

Example response

{
  "verdict": "TENDER",
  "reasons": [],
  "authority": {
    "found": true,
    "verdict": "CLEAR"
  },
  "basics": {
    "found": true,
    "verdict": "CLEAR"
  },
  "ofac": {
    "skipped": true
  },
  "hold_basis": null,
  "sources": [
    {
      "name": "FMCSA QCMobile (US DOT, live)"
    },
    {
      "name": "FMCSA SMS monthly results (data.transportation.gov)",
      "as_of": "2026-10-13T07:05:22.000Z"
    }
  ]
}

Delivers

JSON { verdict: TENDER|HOLD|REJECT, reasons[], hold_basis, partial, sections, authority, basics, broker, ofac, sources[] } with as_of per source. Freight carriers flag only on acute/critical violations (percentiles not public); a stale-data HOLD is labelled data-quality. A section that times out returns status "timeout" (found: null) with partial:true and a HOLD verdict (never TENDER; a REJECT stays REJECT). Full price applies when carrier authority (broker, for a broker-only pack) is delivered; if that core section times out, or every section does, the call fails with 503 before payment settles (Shelf Pass credits refunded).

← all shelves