CarrierScrub

CarrierScrub Authority History API

The Authority History API from CarrierScrub — 1 operation(s) for authority history.

Documentation GitHub OpenAPI

Operations 1

GET /v1/authority-history Every dated grant, suspension, revocation and reinstatement of a carrier's… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/carrierscrub-com:carrierscrub-com-authority-history-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: CarrierScrub Authority History API
  version: 1.0.0
  summary: Check a US motor carrier's FMCSA record before a broker tenders a load.
  description: 'Each check returns a GO, CAUTION or STOP verdict with dated reason codes. Every reason states a fact FMCSA published and its date; none is a conclusion about the company. Every result names the FMCSA record it used (record_source) and that record''s date (record_as_of); the legacy record has been frozen since 2026-05-14. API keys work on every plan: on Pay-as-you-go and Small Brokerage each lookup uses one of the brokerage''s 25 free lookups that month, then a $1.00 credit, and on Agency lookups are unlimited. How to get a key is in https://carrierscrub.com/auth.md. AI assistants can use the same checks through the MCP server at https://carrierscrub.com/mcp.'
  contact:
    email: support@carrierscrub.com
    url: https://carrierscrub.com/contact
  termsOfService: https://carrierscrub.com/terms
servers:
- url: https://carrierscrub.com
security:
- apiKey: []
tags:
- name: Authority History
paths:
  /v1/authority-history:
    get:
      operationId: getAuthorityHistory
      summary: Every dated grant, suspension, revocation and reinstatement of a carrier's…
      description: 'FMCSA''s own authority history for one USDOT number, newest first: Motus (data.transportation.gov yu5v-wbh6), which includes the history imported from the legacy file, or the legacy AuthHist (9mw4-x3tu, frozen 14 May 2026) when Motus holds nothing. Each event keeps FMCSA''s wording in `action`; `kind` (granted, reinstated, suspended, revoked, dismissed, other) names its direction. Facts beside the verdict, never a verdict. Public, cached a day per carrier, and limited per network and site-wide per day.'
      security: []
      parameters:
      - name: dot
        in: query
        required: true
        description: USDOT number.
        schema:
          type: string
          pattern: ^[0-9]{1,8}$
        example: '2589590'
      responses:
        '200':
          description: '`dot_number`, `source` (motus, legacy or none), `events` (date, docket, authority, action, kind; newest first, at most 40), `total` (all events on file) and `checked_at`. `source` none with no events is a real answer: FMCSA holds no authority changes for that number.'
        '400':
          description: Not a USDOT number.
        '429':
          description: This network's daily limit, or the site-wide one, is reached until 00:00 UTC.
        '503':
          description: FMCSA could not be read just now. Nothing is inferred.
      tags:
      - Authority History
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'Authorization: Bearer cs_live_... An owner or admin of the brokerage, on any plan, creates keys in Admin, then API keys. A key that goes unused for 60 days stops working.'
externalDocs:
  description: Getting access
  url: https://carrierscrub.com/auth.md