{"uid":"cap_eTmTBHdA4oCPMZgetHBAA","slug":"u-s-dot-fmcsa-carrier-hire-check-29956a0b","name":"U.S. DOT/FMCSA Carrier Hire Check","description":"An x402-paid API suite for autonomous agents. The freight operation preserves deterministic U.S. DOT/FMCSA carrier checks. A self-contained rental market snapshot returns available public rent benchmarks, trends, provenance, and optional budget fit from a ZIP code and bedroom count. Other rental operations normalize, deduplicate, search, compare, and analyze rental observations supplied by a caller who is authorized to process them. Zillow Research ZORI, U.S. Census ZCTA geography, and HUD Fair Market Rent data are not represented as unit-level listings or executed lease rents. Unsigned requests receive the x402 challenge before validation. Credential-bearing retries that are invalid or cannot produce the advertised minimum result are rejected before payment verification and settlement and are not charged.","url":"https://192.3.171.233/v1/us-freight/carrier-hire-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mc":{"type":"string","pattern":"^((MC|MX|FF)[ -]?)?[0-9]{1,10}$","description":"MC, MX, or FF docket number. A digits-only value is interpreted as MC."},"usdot":{"type":"string","pattern":"^(USDOT[ -]?)?[0-9]{1,8}$","description":"USDOT number. Accepts 1-8 digits, optionally prefixed by USDOT."},"policy":{"type":"object","properties":{"maxSourceAgeHours":{"type":"integer","default":48,"maximum":168,"minimum":1},"requireActiveUsdot":{"type":"boolean","default":true},"requireInsuranceFiling":{"type":"boolean","default":true},"reviewUnratedSafetyRating":{"type":"boolean","default":false},"reviewClaimedIdentityMismatch":{"type":"boolean","default":true},"requireActivePropertyAuthority":{"type":"boolean","default":true},"blockUnsatisfactorySafetyRating":{"type":"boolean","default":true}},"description":"Optional policy overrides. Omitted booleans use the documented defaults.","additionalProperties":false},"claimedIdentity":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":40},"dbaName":{"type":"string","maxLength":160},"legalName":{"type":"string","maxLength":160},"physicalAddress":{"type":"object","properties":{"city":{"type":"string","maxLength":120},"line1":{"type":"string","maxLength":120},"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"postalCode":{"type":"string","maxLength":20}},"additionalProperties":false}},"description":"Optional identity presented by the carrier contact. Supplied fields are compared with official records and are never echoed unmasked.","additionalProperties":false}}},"responseSchema":{"type":"json","example":{"safety":{"rating":"SATISFACTORY"},"carrier":{"usdot":"44110","legalName":"GREYHOUND LINES INC"},"checkId":"chk_62ca5298f07ce5747e89","decision":"PASS","evidence":[{"datasetId":"az4n-8mr2","sourceAsOf":"2026-08-23T10:19:48Z"}],"authority":{"usdotStatus":"ACTIVE","claimedDocketMatched":true,"propertyForHireStatus":"ACTIVE"},"insurance":{"filingEvidenceStatus":"MEETS_REPORTED_FILING_REQUIREMENTS"},"generatedAt":"2026-08-23T21:35:00Z","reasonCodes":["ALL_ENABLED_CHECKS_PASSED"],"schemaVersion":"1.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PChZWfl-L3zsb5gG2d37S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a deterministic hire-eligibility check on a U.S. freight carrier using FMCSA/DOT records, returning a PASS/FAIL decision with authority status, safety rating, insurance filing evidence, and optional identity mismatch flags.","exampleAgentPrompt":"Can you run a carrier hire check on USDOT 44110 with MC number MC-123456 — I need to confirm their operating authority is active, their safety rating isn't unsatisfactory, and that they have insurance filings on file before we put them on our approved carrier list?","exampleUseCases":[{"title":"Pre-dispatch carrier compliance screen","prompt":"Before we assign this load, run a hire check on USDOT 1234567 — make sure their property authority is active, they have a satisfactory safety rating, and their insurance filings are current."},{"title":"Broker onboarding carrier verification","prompt":"We're onboarding a new carrier who gave us MC-987654 and claims to be 'Swift Transport LLC' out of Dallas, TX — can you verify that against FMCSA records and flag any identity mismatches?"},{"title":"Fraud detection on a cold-call carrier","prompt":"A carrier cold-called us with USDOT 5556789 and a MC number. Before we give them any freight, check if their authority is active, their safety record is clean, and that their name and address match what's on file with FMCSA."}],"resultDescription":"Returns a JSON object with a top-level PASS/FAIL decision, a unique checkId, the carrier's legal name and USDOT, authority status (USDOT active/inactive, property-for-hire status), safety rating, insurance filing status, optional claimed-identity match flags, reason codes explaining the outcome, evidence dataset provenance with timestamps, and a generatedAt timestamp. The schema version is included for compatibility tracking.","failureModes":["Invalid or unrecognized MC/USDOT number returns a rejection before payment is charged","Source data older than maxSourceAgeHours policy threshold triggers a staleness rejection","Carrier has UNSATISFACTORY safety rating and blockUnsatisfactorySafetyRating is true — returns FAIL with reason code","Insurance filings absent when requireInsuranceFiling is true — returns FAIL","Identity mismatch detected and reviewClaimedIdentityMismatch is true — returns FAIL or REVIEW decision","USDOT inactive when requireActiveUsdot is true — returns FAIL","x402 payment challenge returned for unsigned or unauthenticated requests","Requests that cannot produce the advertised minimum result are rejected before payment settlement"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs a deterministic, auditable, single-call carrier hire decision backed directly by FMCSA/DOT public records, with configurable policy thresholds (safety rating, insurance, authority, identity match) and evidence provenance. Prefer this over manual FMCSA portal lookups or generic business-verification APIs when you need structured PASS/FAIL output with reason codes, dataset citations, and x402 micropayment billing that only charges on valid, result-producing calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:34:49.343Z","isFirstParty":false,"canonicalSlug":"u-s-dot-fmcsa-carrier-hire-check-29956a0b"}