Api Endpoint

tollbooth

US motor carrier by USDOT, MC/MX/FF docket or exact company name (FMCSA): USDOT status, out-of-service order, operating authority per docket with grant date and source (Motus, else legacy frozen 2026-05-14), BI&PD, cargo and bond required vs on file, insurance policies, BOC-3, fleet size (power_units counts every power unit, trucks and others), safety rating. Up to 10 carriers; empty is a paid 200. Not a determination: verify with FMCSA before dispatch.

Open interactive test console

Offering

Provider
api.flipvo.com
Method
POST
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://api.flipvo.com/v1/carrier/lookup
MIME type
Not provided
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
compliance, transportation, fmcsa, carrier

Payment pricing

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

Payment option 1
0.03 USDC
Atomic price: 30000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "30000",
    "payTo": "0x849610c11c1e9b309235932faab6368cee7f7c57"
  }
]

Observed health

Status
Reachable
Latest latency
949 ms
Average latency
685 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

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

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "description": "Exactly one of usdot, docket or name.",
      "oneOf": [
        {
          "required": [
            "usdot"
          ]
        },
        {
          "required": [
            "docket"
          ]
        },
        {
          "required": [
            "name"
          ]
        }
      ],
      "properties": {
        "docket": {
          "anyOf": [
            {
              "maxLength": 20,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "MC, MX or FF + digits.",
          "examples": [
            "MC138328"
          ],
          "title": "Docket"
        },
        "name": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Whole legal or DBA name; no partial match.",
          "title": "Name"
        },
        "usdot": {
          "anyOf": [
            {
              "maximum": 99999999,
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "examples": [
            53467
          ],
          "title": "Usdot"
        }
      },
      "title": "CarrierLookupRequest",
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "carriers": {
          "items": {
            "properties": {
              "authorities": {
                "items": {
                  "properties": {
                    "docket": {
                      "title": "Docket",
                      "type": "string"
                    },
                    "frozen_as_of": {
                      "anyOf": [
                        {
                          "format": "date",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Frozen As Of"
                    },
                    "granted": {
                      "anyOf": [
                        {
                          "format": "date",
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Granted"
                    },
                    "source": {
                      "title": "Source",
                      "type": "string"
                    },
                    "status": {
                      "title": "Status",
                      "type": "string"
                    },
                    "type": {
                      "title": "Type",
                      "type": "string"
                    }
                  },
                  "required": [
                    "docket",
                    "type",
                    "status",
                    "granted",
                    "source",
                    "frozen_as_of"
                  ],
                  "title": "CarrierAuthority",
                  "type": "object"
                },
                "title": "Authorities",
                "type": "array"
              },
              "authority_age": {
                "properties": {
                  "docket": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "title": "Docket"
                  },
                  "first_granted": {
                    "anyOf": [
                      {
                        "format": "date",
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "title": "First Granted"
                  },
                  "source": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "title": "Source"
                  }
                },
                "required": [
                  "first_granted",
                  "docket",
                  "source"
                ],
                "title": "CarrierAuthorityAge",
                "type": "object"
              },
              "authorized_for": {
                "items": {
                  "type": "string"
                },
                "title": "Authorized For",
                "type": "array"
              },
              "boc3": {
                "title": "Boc3",
                "type": "boolean"
              },
              "city": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "City"
              },
              "dba_name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Dba Name"
              },
              "drivers": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Drivers"
              },
              "insurance": {
                "items": {
                  "properties": {
                    "bipd_on_file": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Bipd On File"
                    },
                    "bipd_required": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Bipd Required"
                    },
                    "boc3": {
                      "title": "Boc3",
                      "type": "boolean"
                    },
                    "bond_on_file": {
                      "anyOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Bond On File"
                    },
                    "bond_required": {
                      "anyOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Bond Required"
                    },
                    "cargo_on_file": {
                      "anyOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Cargo On File"
                    },
                    "cargo_required": {
                      "anyOf": [
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Cargo Required"
                    },
                    "docket": {
                      "title": "Docket",
                      "type": "string"
                    },
                    "policies": {
                      "items": {
                        "properties": {
                          "cancellation_effective": {
                            "anyOf": [
                              {
                                "format": "date",
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Cancellation Effective"
                          },
                          "coverage": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Coverage"
                          },
                          "effective_date": {
                            "anyOf": [
                              {
                                "format": "date",
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Effective Date"
                          },
                          "form": {
                            "title": "Form",
                            "type": "string"
                          },
                          "insurer": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Insurer"
                          },
                          "type": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Type"
                          },
                          "underlying_limit": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Underlying Limit"
                          }
                        },
                        "required": [
                          "form",
                          "type",
                          "insurer",
                          "effective_date",
                          "coverage",
                          "underlying_limit",
                          "cancellation_effective"
                        ],
                        "title": "CarrierPolicy",
                        "type": "object"
                      },
                      "title": "Policies",
                      "type": "array"
                    },
                    "source": {
                      "title": "Source",
                      "type": "string"
                    }
                  },
                  "required": [
                    "docket",
                    "source",
                    "bipd_required",
                    "bipd_on_file",
                    "cargo_required",
                    "cargo_on_file",
                    "bond_required",
                    "bond_on_file",
                    "boc3",
                    "policies"
                  ],
                  "title": "CarrierInsurance",
                  "type": "object"
                },
                "title": "Insurance",
                "type": "array"
              },
              "legal_name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Legal Name"
              },
              "out_of_service": {
                "properties": {
                  "date": {
                    "anyOf": [
                      {
                        "format": "date",
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "title": "Date"
                  },
                  "in_force": {
                    "title": "In Force",
                    "type": "boolean"
                  },
                  "reason_class": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "title": "Reason Class"
                  }
                },
                "required": [
                  "in_force",
                  "date",
                  "reason_class"
                ],
                "title": "CarrierOutOfService",
                "type": "object"
              },
              "power_units": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Every power unit the carrier reports, trucks and others; not trucks only.",
                "title": "Power Units"
              },
              "safety_rating": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Safety Rating"
              },
              "safety_rating_date": {
                "anyOf": [
                  {
                    "format": "date",
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Safety Rating Date"
              },
              "state": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "State"
              },
              "usdot": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Usdot"
              },
              "usdot_status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Usdot Status"
              },
              "zip": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Zip"
              }
            },
            "required": [
              "usdot",
              "legal_name",
              "dba_name",
              "usdot_status",
              "city",
              "state",
              "zip",
              "power_units",
              "drivers",
              "safety_rating",
              "safety_rating_date",
              "out_of_service",
              "authorized_for",
              "authorities",
              "insurance",
              "boc3",
              "authority_age"
            ],
            "title": "CarrierRecord",
            "type": "object"
          },
          "title": "Carriers",
          "type": "array"
        },
        "coverage": {
          "title": "Coverage",
          "type": "string"
        },
        "data_as_of": {
          "title": "Data As Of",
          "type": "string"
        },
        "legacy_as_of": {
          "format": "date",
          "title": "Legacy As Of",
          "type": "string"
        },
        "source": {
          "title": "Source",
          "type": "string"
        },
        "truncated": {
          "title": "Truncated",
          "type": "boolean"
        }
      },
      "required": [
        "carriers",
        "truncated",
        "data_as_of",
        "legacy_as_of",
        "source",
        "coverage"
      ],
      "title": "CarrierLookupResponse",
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}