US carrier authority & safety check (FMCSA)
Live federal FMCSA record for a US motor carrier: legal name, operating status (allowed to operate), authority, safety rating, fleet size, crash and inspection summary — with plain risk flags. The check a freight-broker or dispatch agent runs before tendering a load.
$0.10 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.
Parameters
| param | description |
|---|---|
dot | USDOT number (this or mc required) |
mc | MC/docket number (this or dot required) |
Call it (any x402 client)
# 1. GET without payment → HTTP 402 with PAYMENT-REQUIRED (price, payTo, scheme "exact")
curl -i "https://ai-money-endpoint.nibiashara.workers.dev/shelf/carrier-authority-check?dot=44110&mc=515000"
# 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://ai-money-endpoint.nibiashara.workers.dev/shelf/carrier-authority-check?dot=44110&mc=515000");
const data = await res.json();
Or install the MCP server (https://ai-money-endpoint.nibiashara.workers.dev/mcp, registry id biz.nibiashara/shelves) and use the job-named tool for this shelf, or buy_shelf as an escape hatch.
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 10 credits per call.Example response
{
"found": true,
"carrier": {
"legal_name": "EXAMPLE TRUCKING LLC",
"allowed_to_operate": "Y"
},
"authority": {
"common": "A"
},
"safety": {
"rating": "S"
},
"flags": [],
"verdict": "CLEAR"
}
Delivers
JSON { carrier, authority, safety, flags[] } from FMCSA QCMobile (live)