CarrierVet

Get a US motor carrier's FMCSA profile by USDOT number or MC/FF/MX docket number: legal name, operating authority status and age, insurance on file, out-of-service status, fleet size, address and contact. Returns an overall verdict (PASS, REVIEW or FAIL) with verdict_reasons, based on the PASS/FLAG/FAIL checks for authority, insurance, out-of-service, USDOT operating status and FMCSA safety rating: FAIL if any check is FAIL, REVIEW if any is FLAG, PASS otherwise. Pass exactly one of dot or mc. The response includes receipt_id; get_receipt returns the saved copy of this response later. Costs 1 lookup.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "pattern": "^[0-9]{1,8}$",
      "description": "USDOT number, 1-8 digits, e.g. \"1234567\""
    },
    "mc": {
      "type": "string",
      "description": "MC, FF or MX docket number, e.g. \"MC123456\" or \"123456\""
    }
  },
  "additionalProperties": false
}

Get a 0-100 risk score for a carrier by USDOT number or MC/FF/MX docket number, with reason codes (e.g. insurance_lapsed, authority_under_90_days, shared_phone, multiple_contact_changes). Levels: low 0-24, elevated 25-49, high 50-74, severe 75-100. Hard failures (revoked, inactive or missing authority, out-of-service, lapsed or missing insurance, inactive USDOT number, not allowed to operate, Unsatisfactory safety rating) are listed in gates and keep the score at 50 or more, so a carrier that fails one is never low. With mc, the authority status is that docket's own. Also returns an overall verdict (PASS, REVIEW or FAIL) with verdict_reasons, and receipt_id. Informational signal for human review, not a safety rating. Pass exactly one of dot or mc. Costs 1 lookup.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "pattern": "^[0-9]{1,8}$",
      "description": "USDOT number, 1-8 digits, e.g. \"1234567\""
    },
    "mc": {
      "type": "string",
      "description": "MC, FF or MX docket number, e.g. \"MC123456\" or \"123456\""
    }
  },
  "additionalProperties": false
}

Fetch the saved copy of an earlier lookup by its receipt_id: the time it was made, the endpoint, the identifier, and the exact response CarrierVet returned, with its SHA-256. Any API key on the account that made the lookup can read it. Receipts are saved a few seconds after the lookup. Free; does not cost a lookup.

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "type": "string",
      "description": "receipt_id from an earlier response, e.g. rcpt_0123abcd..."
    }
  },
  "required": [
    "receipt_id"
  ],
  "additionalProperties": false
}

List changes CarrierVet detected in a carrier's FMCSA record (address, phone, email, authority, insurance, out-of-service), newest first, plus fmcsa_history: dated changes from FMCSA's daily files and census, each with the date FMCSA recorded it, the date CarrierVet saw it, and the before and after values. History starts on the date CarrierVet began recording, so older changes are not included. Recent contact changes are a common double-brokering warning sign. Costs 1 lookup.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "pattern": "^[0-9]{1,8}$",
      "description": "USDOT number, 1-8 digits, e.g. \"1234567\""
    }
  },
  "required": [
    "dot"
  ],
  "additionalProperties": false
}

Find carriers already stored by CarrierVet whose legal or DBA name contains the given text (max 25). Prefer lookup_carrier when you have a USDOT or MC number. Costs 1 lookup.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "description": "Company name or part of it"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Look up to 500 USDOT or MC numbers in one call from stored snapshots (Pro and Business plans). Each found result includes the same verdict, verdict_reasons and verdict_basis as lookup_carrier. Costs 1 lookup per unique identifier.

{
  "type": "object",
  "properties": {
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 500,
      "description": "USDOT numbers and/or MC numbers like \"MC123456\""
    }
  },
  "required": [
    "identifiers"
  ],
  "additionalProperties": false
}

Show this API key's plan, lookups used and remaining this UTC month, monitor count and rate limit. Free; does not cost a lookup.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List carriers on this account's watchlist (monitors) with alert email, webhook and last delivery status.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Watch a carrier (paid plans) and get an email and/or signed webhook (Pro+) when its FMCSA record changes. The carrier must have been looked up at least once. Provide alert_email, webhook_url, or both.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "pattern": "^[0-9]{1,8}$",
      "description": "USDOT number, 1-8 digits, e.g. \"1234567\""
    },
    "alert_email": {
      "type": "string",
      "format": "email"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "HTTPS URL (Pro and Business)"
    }
  },
  "required": [
    "dot"
  ],
  "additionalProperties": false
}

Stop watching a carrier on this account.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "pattern": "^[0-9]{1,8}$",
      "description": "USDOT number, 1-8 digits, e.g. \"1234567\""
    }
  },
  "required": [
    "dot"
  ],
  "additionalProperties": false
}