FMCSA API Documentation

Complete reference for AlphaLoops's carrier data API. Look up carriers by DOT number, MC number, or name. Access safety data, authority status, technology stack, and more.

New to FMCSA data? Start with our complete guide →

Quick Start

Base URL

https://api.runalphaloops.com

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

Standard plans support 10,000 requests per minute. Enterprise plans have custom rate limits. Rate limit headers are included in every response:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9847
X-RateLimit-Reset: 1709325600

Endpoints

GET/v1/carriers/{dot_number}

Look up a carrier by DOT number. Returns the full carrier profile with 200+ fields.

Parameters

Name	Type	Required	Description
dot_number	string	Yes	The carrier's USDOT number

Response Example

{
  "dot_number": "2247505",
  "legal_name": "SWIFT TRANSPORTATION CO OF ARIZONA LLC",
  "dba_name": "SWIFT TRANSPORTATION",
  "authority_status": "AUTHORIZED",
  "authority_types": ["COMMON", "CONTRACT"],
  "physical_address": {
    "street": "2200 S 75TH AVE",
    "city": "PHOENIX",
    "state": "AZ",
    "zip": "85043"
  },
  "power_units": 18643,
  "drivers": 22891,
  "safety_rating": "SATISFACTORY",
  "oos_rate": 4.2,
  "technology": {
    "eld_provider": "Platform Science",
    "tms": "Oracle TMS",
    "fuel_card": "Comdata"
  },
  "contacts": [
    {
      "name": "John Smith",
      "title": "VP of Safety",
      "email": "jsmith@example.com"
    }
  ]
}

GET/v1/carriers/mc/{mc_number}

Look up a carrier by MC/MX docket number.

Parameters

Name	Type	Required	Description
mc_number	string	Yes	The carrier's MC or MX docket number

Response Example

{
  "dot_number": "2247505",
  "mc_number": "MC-728261",
  "legal_name": "SWIFT TRANSPORTATION CO OF ARIZONA LLC",
  "authority_status": "AUTHORIZED"
  // ... full carrier profile
}

GET/v1/carriers/search

Search carriers by name (fuzzy matching), state, fleet size, authority type, and more.

Parameters

Name	Type	Required	Description
q	string	No	Search query (carrier name, fuzzy matching)
state	string	No	State abbreviation (e.g. "TX", "CA")
min_power_units	number	No	Minimum fleet size
max_power_units	number	No	Maximum fleet size
authority_status	string	No	"AUTHORIZED", "NOT_AUTHORIZED", "REVOKED"
authority_type	string	No	"COMMON", "CONTRACT", "BROKER"
page	number	No	Page number (default: 1)
limit	number	No	Results per page (default: 25, max: 100)

Response Example

{
  "results": [
    {
      "dot_number": "2247505",
      "legal_name": "SWIFT TRANSPORTATION CO OF ARIZONA LLC",
      "authority_status": "AUTHORIZED",
      "power_units": 18643,
      "physical_state": "AZ"
    }
    // ... more results
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total_results": 142,
    "total_pages": 6
  }
}

GET/v1/carriers/{dot_number}/safety

Get detailed safety data including BASIC scores, inspection history, and crash records.

Parameters

Name	Type	Required	Description
dot_number	string	Yes	The carrier's USDOT number

Response Example

{
  "dot_number": "2247505",
  "safety_rating": "SATISFACTORY",
  "basics": {
    "unsafe_driving": { "percentile": 22, "violations": 156 },
    "fatigued_driving": { "percentile": 45, "violations": 89 },
    "driver_fitness": { "percentile": 12, "violations": 23 },
    "controlled_substances": { "percentile": 8, "violations": 11 },
    "vehicle_maintenance": { "percentile": 34, "violations": 201 }
  },
  "inspections": {
    "total": 4521,
    "violations": 892,
    "oos_count": 190,
    "oos_rate": 4.2
  },
  "crashes": {
    "total": 89,
    "fatalities": 2,
    "injuries": 34
  }
}

GET/v1/carriers/{dot_number}/authority

Get operating authority details including types, effective dates, and revocation history.

Parameters

Name	Type	Required	Description
dot_number	string	Yes	The carrier's USDOT number

Response Example

{
  "dot_number": "2247505",
  "authorities": [
    {
      "type": "COMMON",
      "status": "ACTIVE",
      "effective_date": "1990-06-15",
      "docket_number": "MC-728261"
    },
    {
      "type": "CONTRACT",
      "status": "ACTIVE",
      "effective_date": "1992-03-22",
      "docket_number": "MC-728261"
    }
  ],
  "revocation_history": []
}

Error Codes

Code	Description
200	Success
400	Bad Request — invalid parameters
401	Unauthorized — invalid or missing API key
404	Not Found — carrier does not exist
429	Rate Limited — too many requests
500	Internal Server Error

Need API Access?

Contact our team to get your API key and start building with FMCSA carrier data.

Get API Access