API & MCP reference

1 · new_authority the lead signal

Newly-authorized carriers, newest first. Filter by state, fleet size, has-email. Each row is a lead.

GET /v1/new_authority
  ?state=TX            # 2-letter state
  &hasEmail=true       # only carriers with an email on file
  &minPowerUnits=2     # fleet-size floor
  &since=2026-06-14    # only authorities on/after this date
  &limit=100

# response
{ "asOf":"2026-06-20","totalNewInWindow":2639,"count":100,
  "carriers":[ {"dot":"4321987","name":"MONTERO DELIVERY LLC","state":"NC",
     "city":"...","email":"...","phone":"...","powerUnits":4,"drivers":2,
     "addDate":"2026-06-20","mcNumber":"MC1234567"} ] }

2 · carrier_lookup

Full safety + contact profile for any USDOT number.

GET /v1/carrier?dot=80321

3 · search_carriers

GET /v1/search?state=CA&minPowerUnits=5&hasEmail=true&limit=200

4 · safety_screen underwriting

Risk verdict for a DOT: out-of-service rate, FMCSA rating, authority status, flags.

GET /v1/safety_screen?dot=80321

5 · MCP (agent-callable)

Point any MCP client at https://freight.dropwatchhq.com/mcp (Streamable HTTP, JSON-RPC 2.0). Tools: new_authority_feed, carrier_lookup, search_carriers, safety_screen.

curl -s https://freight.dropwatchhq.com/mcp -H "content-type: application/json" \
  -H "x-api-key: fik_live_xxx" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"new_authority_feed","arguments":{"state":"TX","hasEmail":true}}}'

6 · Saved filters, watchlists & webhooks paid tiers

POST /v1/filters    {"name":"tx-new","filter":{"state":"TX","hasEmail":true}}
POST /v1/watchlist  {"dot":"80321","webhook":"https://your.app/hook"}
# We POST {event,carrier} to your webhook when a watched DOT changes or a new
# carrier matches a saved filter on the daily refresh.

Honest scope

Carrier identity, authority date, contact, and safety aggregates are real and source-linked to FMCSA / USDOT. New-authority is the freshest signal. search runs over the new-authority window we hold inline; use carrier_lookup for any DOT in the snapshot. We never fabricate an email or a safety rating.