Ni Biashara Shelvespay-per-call APIs for AI agents · x402 · USDC on Base
data · instant

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

paramdescription
dotUSDOT number (this or mc required)
mcMC/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)

← all shelves