# CarrierOk

> The most current and most complete FMCSA carrier data API. 4M+ motor carriers and brokers, 280+ fields per record, refreshed 4x daily. Includes all 7 BASIC percentiles (Crash Indicator and Hazmat), policy-level insurance history, VIN-decoded fleet composition with per-vehicle inspections, and 50+ risk signals. Lookup by DOT, MC, EIN, phone, email, address, VIN, plate, unit number, or company name.

## APIs

- Carrier Profile (/v2/profile): Full carrier data — all 7 BASIC percentiles (including Crash Indicator and Hazmat), ISS scores, 50+ risk signals, policy-level insurance history, and VIN-decoded fleet composition.
- Carrier Profile Lite (/v2/profile-lite): Reduced field set for high-volume integrations and browser extensions. Same search keys as /v2/profile.
- FMCSA Profile (/v2/profile-fmcsa): Consolidated FMCSA data only — 236 fields (registration, authority, safety, inspections, crashes, insurance filings), fixed null-filled schema, $0.10 per matched lookup. No CarrierOk-derived scoring. Quickstart: https://developers.carrierok.com/docs/guides/fmcsa-api-quickstart
- Autocomplete (/v2/autocomplete): Sub-100ms typeahead by name or DOT.
- Monitoring (/v2/monitoring/add, /v2/monitoring/remove, /v2/monitoring/list): Watchlist with real-time alerts on authority, insurance, safety, fleet, contact, and risk-factor changes. Granular per-channel filters.

## Authentication

`Authorization: Bearer sk_*` header. Sign up at https://developers.carrierok.com for a free sandbox key (fixture data, 10 hand-picked carriers — useful for evaluation and CI). Activate live access for $50 — applied as $50 of API credit, pay-as-you-go from card on file after credit drains.

## Built for

- **Insurance underwriting**: all 7 BASIC percentiles, policy-level insurance history (cancellations, lapses, carrier changes), 50+ risk signals, and chameleon-detection signals in one call. Replaces stitching together CAB + FMCSA SAFER + carrier-supplied COIs.
- **Sales prospecting & CRM enrichment**: enrich a known contact — phone, email, name, address — into a full carrier profile with fleet composition, equipment, age, and recent activity. Lookup by current or historical DBAs, EINs, and contact info. Built for SDR workflows, CRM hygiene, and pre-call research.
- **Factoring & financial services**: authority age, EIN/ownership history, name-change chains, MCS-150 cadence, and OOS trend in one lookup. Built for credit decisions and chameleon screening.
- **Freight brokers & 3PLs**: real-time authority, insurance, and safety status, refreshed 4x daily. Plate, VIN, and unit-number lookups for driver-at-the-dock verification.
- **Platform partners & OEMs**: high-QPS lookups, full field coverage, idempotency-keyed write endpoints for monitoring at scale. Embedded in TMS, telematics, ELD, and freight-matching platforms.

## Pricing

Pay-as-you-go. No tiers, no monthly minimums, no commitments.

- Sandbox: Free with signup. 10 hand-picked carriers, fixture data, unlimited evaluation calls. No card required.
- Live: $50 activation = $50 credit. Per-call billing after credit drains. US and Canada.
- Volume / OEM: Custom rates. Contact sales.

## Docs

- API Reference: https://developers.carrierok.com/docs
- OpenAPI Spec (3.0.3, typed responses + examples): https://developers.carrierok.com/openapi.json
- Full LLM Reference (expanded, single file): https://developers.carrierok.com/llms-full.txt
- Data Dictionary (all response fields): https://developers.carrierok.com/docs/data-dictionary
- Glossary (FMCSA/trucking terms): https://developers.carrierok.com/glossary

## Guides

- Underwriting Risk Check (tiered determination from one call): https://developers.carrierok.com/docs/guides/underwriting-risk-check
- CarrierOk vs FMCSA Sources (SAFER / QCMobile / SMS / L&I): https://developers.carrierok.com/docs/guides/carrierok-vs-fmcsa-sources
- All 7 BASIC Percentiles (incl. Crash Indicator & Hazmat): https://developers.carrierok.com/docs/guides/basic-percentiles
- Quick Start (first lookup in 5 minutes): https://developers.carrierok.com/docs/guides/get-started
- FMCSA API Quickstart (consolidated FMCSA data in 5 minutes): https://developers.carrierok.com/docs/guides/fmcsa-api-quickstart
- Monitor Carrier Authority: https://developers.carrierok.com/docs/guides/monitor-carrier-authority
- Build a Carrier Vetting View: https://developers.carrierok.com/docs/guides/build-carrier-profile
- Migrate from the Legacy API (gateway.dev / X-Api-Key): https://developers.carrierok.com/docs/guides/migrate-legacy-api
- API Landing: https://carrierok.com/fmcsa-api
- Developer Portal: https://developers.carrierok.com
- Contact: support@carrierok.com