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.
Authentication
Include your
Access-Tokenin the header of your requests.Include your
x-api-keyThe API key provided by GenLogs. This header must be included in the request.
Permissions
external-api-carrier-fmcsa-insurance
Required to access this endpoint
Endpoint
URL:
https://api.genlogs.io/carrier/profile/fmcsa/insuranceMethod:
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
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
insurancesection per requested USDOT.400 Bad Request: If
usdot_numberis 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-insurancepermission 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 byusdot_number.
Request Example:
Response Example:
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.
USDOT numbers to get FMCSA insurance for
Token for authentication
GenLogs generated API Key for authentication
Successful response
Bad Request - invalid or missing usdot_number
Unauthorized – missing token
Forbidden – invalid token or insufficient permissions
Not Found - none of the requested USDOT numbers exist
Internal Server Error
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"
}
]
}
}
}Last updated