CarrierScrub Fmcsa Activity API

openapi: 3.2.0
info:
  title: CarrierScrub Fmcsa Activity 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: Fmcsa Activity
paths:
  /v1/fmcsa-activity:
    get:
      operationId: getFmcsaActivity
      summary: How many carriers' FMCSA authority, insurance and contact records changed in a…
      description: 'The counts behind https://carrierscrub.com/news and https://carrierscrub.com/fmcsa-weekly-report, counted by comparing each day''s copy of FMCSA''s Motus Carrier and Company Census datasets with the day before. Aggregates only; no carrier is named. Public: no API key, and it does not count toward any limit. Counts begin 2026-10-06. The MCP tool get_fmcsa_activity returns the same answer.'
      security: []
      parameters:
      - name: period
        in: query
        required: false
        description: '"week" (default): the latest complete Monday-to-Sunday week, or the week containing `date`. "day": the latest day with counts, or `date`.'
        schema:
          type: string
          enum:
          - week
          - day
          default: week
      - name: date
        in: query
        required: false
        description: A day, YYYY-MM-DD. For a week, any day in it.
        schema:
          type: string
          format: date
        example: '2026-10-12'
      responses:
        '200':
          description: The period's counts with a dated `summary` to quote, the period's headlines for freight brokers (`carrierscrub_takeaway` is CarrierScrub's AI-written sentence), `url` to cite and `source`. A week also has `totals`, `days`, `complete`, `days_counted` and `change_vs_prior_week` (null unless both weeks are complete with all seven days counted); a day has `activity` (null when that day has no counts).
          content:
            application/json:
              schema:
                type: object
                properties:
                  period:
                    type: string
                    enum:
                    - week
                    - day
                  summary:
                    type:
                    - string
                    - 'null'
                  url:
                    type: string
                    format: uri
                  headlines:
                    type: array
                    items:
                      type: object
                  source:
                    type: object
                required:
                - period
                - summary
                - url
                - headlines
                - source
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
      tags:
      - Fmcsa Activity
components:
  responses:
    Error:
      description: 'The check was not completed. 401: no key, or the key is invalid, expired or revoked. 402 (code payg_credits_exhausted): the brokerage has used its free lookups this month and has no credits left; the hint says where to buy them. 404: no carrier for that number. 413: the file is too large. 429: daily limit reached. 503: FMCSA could not be reached and no dated record is on file.'
      content:
        application/json:
          schema:
            type: object
            required:
            - error
            properties:
              error:
                type: string
              hint:
                type: string
  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