Carrier FMCSA Insurance

Carrier FMCSA Insurance Endpoint

Retrieve standalone FMCSA insurance data (active insurance and insurance history) for one or more carriers, without pulling FMCSA detail, sightings, equipment, or scores.

Need everything at once (FMCSA detail, equipment pairings, sightings, and all FI-aligned sections)? Use GET /carrier/profile instead ( Carrier Profile Endpoint ) — it returns everything in one call, including this insurance section.

Authentication

• Include your Access-Token in the header of your requests.

• Include your x-api-key The API key provided by GenLogs. This header must be included in the request.

Permissions

Permission	Effect
external-api-carrier-fmcsa-insurance	Required to access this endpoint

Endpoint

• URL: https://api.genlogs.io/carrier/profile/fmcsa/insurance

• Method: GET

Headers

• Access-Token: (string, required): Access token obtained from the "Create Access Token" endpoint.

• x-api-key (string, required): The API key provided by GenLogs.

Query Parameters:

• usdot_number (array of string, required): One or more USDOT numbers; repeat the parameter for multiple values, e.g. ?usdot_number=10553&usdot_number=2350084.

Understanding FMCSA insurance information

Responses are grouped by USDOT. Each USDOT that exists in FMCSA data returns an insurance object with a policies array; USDOTs that don't exist are omitted from the response entirely (not returned as an empty object).

FMCSA Insurance returns one object per USDOT:

• insurance: Active insurance and insurance history for the carrier.

  • policies (array): One entry per insurance policy on file.

    • insurer_name: (string, nullable) The name of the insurance company providing coverage for the carrier.

    • policy_type: (string, nullable) The type of insurance policy (e.g., BIPD, Cargo).

    • max_coverage_amount: (number, nullable) The maximum coverage amount in US dollars (USD).

    • underlying_limit_amount: (number, nullable) The underlying / minimum coverage limit in US dollars (USD).

    • effective_date: (string, nullable) The start date of the insurance policy (YYYY-MM-DD).

    • expiration_date: (string, nullable) The end date of the insurance policy (YYYY-MM-DD).

Response:

• 200 OK: A JSON object containing an insurance section per requested USDOT.

• 400 Bad Request: If usdot_number is missing, empty, or exceeds the allowed limit.

• 401 Unauthorized: If the authentication credentials (Access-Token) is missing or incorrect.

• 403 Forbidden: If the external-api-carrier-fmcsa-insurance permission has not been added to your user.

• 404 Not Found: If none of the requested USDOT numbers exist.

• 500 Internal Server Error: If there is an issue on the server that prevents processing the request.

Response Body:

• Data (object): Set of { "insurance": { "policies": [...] } } objects grouped by usdot_number.

Request Example:

curl --location 'https://api.genlogs.io/carrier/profile/fmcsa/insurance?usdot_number=10553' \
--header 'Access-Token: {your-user-token}' \
--header 'x-api-key: {your-x-api-key}'

Response Example:

{
  "10553": {
    "insurance": {
      "policies": [
        {
          "insurer_name": "Example Insurance Co",
          "policy_type": "BIPD",
          "max_coverage_amount": 1000000,
          "underlying_limit_amount": 750000,
          "effective_date": "2024-01-01",
          "expiration_date": "2025-01-01"
        }
      ]
    }
  }
}

Get carrier FMCSA insurance

get

Retrieve standalone FMCSA insurance data (active insurance and insurance history) for specified USDOT numbers, without pulling FMCSA detail, sightings, equipment, or scores. Roles must include external-api-carrier-fmcsa-insurance.

Query parameters

usdot_numberstring[]Required

USDOT numbers to get FMCSA insurance for

Header parameters

Access-TokenstringRequired

Token for authentication

x-api-keystringRequired

GenLogs generated API Key for authentication

Responses

200

Successful response

application/json

400

Bad Request - invalid or missing usdot_number

application/json

401

Unauthorized – missing token

application/json

403

Forbidden – invalid token or insufficient permissions

application/json

404

Not Found - none of the requested USDOT numbers exist

application/json

500

Internal Server Error

application/json

get/carrier/profile/fmcsa/insurance

GET /carrier/profile/fmcsa/insurance?usdot_number=text HTTP/1.1
Host: api.genlogs.io
Access-Token: text
x-api-key: text
Accept: */*

{
  "10553": {
    "insurance": {
      "policies": [
        {
          "insurer_name": "Example Insurance Co",
          "policy_type": "BIPD",
          "max_coverage_amount": 1000000,
          "underlying_limit_amount": 750000,
          "effective_date": "2024-01-01",
          "expiration_date": "2025-01-01"
        }
      ]
    }
  }
}