Api Endpoint

freight-carrier

Fit-to-haul verdict for a US motor carrier from FMCSA registration data. Give one of dot, mc or name and get a verdict (fit, caution, unfit or not_found), a 0-100 fit score, per-dimension flags, reasons and weighted signals across authority status, operation, hazmat, safety rating, history, registration freshness, address and fleet. Deterministic, no LLM. Carrier vetting indicators, not legal or compliance advice.

Open interactive test console

Offering

Provider
payai.agentstools.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Legal And Compliance
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://payai.agentstools.dev/freight/carrier
MIME type
application/json
First seen
2026-10-16T02:01:31.612Z
Last seen
Tags
freight, logistics, carrier, trucking, fmcsa, dot, mc-number, vetting, due-diligence, broker, supply-chain, compliance

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.02 USDC
Atomic price: 20000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "20000",
    "payTo": "AytHnvc6bZx1ALTy7b5Px7hcavoSYszG9aeKvDcZ8R1u"
  }
]

Observed health

Status
Healthy
Latest latency
361 ms
Average latency
907 ms
HTTP status
402
Last checked
Reachability
100% over 10 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "dot": {
          "type": "string",
          "description": "USDOT number of the carrier"
        },
        "mc": {
          "type": "string",
          "description": "MC, MX or FF docket number (digits only, no prefix)"
        },
        "name": {
          "type": "string",
          "description": "Carrier legal name (best match is used)"
        },
        "haul_type": {
          "type": "string",
          "enum": [
            "general",
            "hazmat",
            "household_goods",
            "passengers",
            "oil"
          ],
          "description": "Type of haul to check fitness for, default general"
        },
        "state": {
          "type": "string",
          "description": "Optional 2-letter state hint to disambiguate a name"
        }
      },
      "required": []
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "object",
      "required": [
        "type",
        "method"
      ],
      "properties": {
        "type": {
          "type": "string",
          "const": "http"
        },
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "type": "object",
          "required": [],
          "properties": {
            "mc": {
              "type": "string",
              "description": "MC, MX or FF docket number (digits only, no prefix)"
            },
            "dot": {
              "type": "string",
              "description": "USDOT number of the carrier"
            },
            "name": {
              "type": "string",
              "description": "Carrier legal name (best match is used)"
            },
            "state": {
              "type": "string",
              "description": "Optional 2-letter state hint to disambiguate a name"
            },
            "haul_type": {
              "enum": [
                "general",
                "hazmat",
                "household_goods",
                "passengers",
                "oil"
              ],
              "type": "string",
              "description": "Type of haul to check fitness for, default general"
            }
          }
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object"
        }
      }
    }
  }
}