> For the complete documentation index, see [llms.txt](https://docs.genlogs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.genlogs.io/carrier/carrier-profile/carrier-fmcsa-insurance.md). # 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. {% hint style="info" %} Need everything at once (FMCSA detail, equipment pairings, sightings, and all FI-aligned sections)? Use `GET /carrier/profile` instead ( [Carrier Profile](/carrier/carrier-profile.md#carrier-profile-endpoint) ) — it returns everything in one call, including this `insurance` section. {% endhint %} ### **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 {% hint style="info" %} 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). {% endhint %} **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: ```json { "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 > 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\`.
```json {"openapi":"3.0.3","info":{"title":"Carrier Profile API","version":"1.0.0"},"tags":[{"name":"Carrier Profile","description":"Carrier profile endpoint"}],"servers":[{"url":"https://api.genlogs.io","description":"Production"}],"paths":{"/carrier/profile/fmcsa/insurance":{"get":{"tags":["Carrier Profile"],"summary":"Get carrier FMCSA insurance","description":"Retrieve standalone FMCSA insurance data (active insurance and insurance history) for specified USDOT numbers, without pulling FMCSA detail, sightings, equipment, or scores.\nRoles must include `external-api-carrier-fmcsa-insurance`.\n","operationId":"getCarrierFmcsaInsurance","parameters":[{"in":"header","name":"Access-Token","required":true,"schema":{"type":"string"},"description":"Token for authentication"},{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string"},"description":"GenLogs generated API Key for authentication"},{"in":"query","name":"usdot_number","required":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":false,"description":"USDOT numbers to get FMCSA insurance for"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/FmcsaInsuranceItem"}}}}},"400":{"description":"Bad Request - invalid or missing usdot_number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized – missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden – invalid token or insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found - none of the requested USDOT numbers exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"FmcsaInsuranceItem":{"type":"object","description":"Per-USDOT payload for `GET /carrier/profile/fmcsa/insurance`.","properties":{"insurance":{"$ref":"#/components/schemas/Insurance"}},"required":["insurance"]},"Insurance":{"type":"object","properties":{"policies":{"type":"array","items":{"$ref":"#/components/schemas/InsurancePolicy"}}}},"InsurancePolicy":{"type":"object","properties":{"insurer_name":{"type":"string","nullable":true},"policy_type":{"type":"string","nullable":true},"max_coverage_amount":{"type":"number","format":"float","nullable":true,"description":"Maximum coverage amount in US dollars (USD)."},"underlying_limit_amount":{"type":"number","format":"float","nullable":true,"description":"Underlying / minimum coverage limit in US dollars (USD)."},"effective_date":{"type":"string","format":"date","nullable":true},"expiration_date":{"type":"string","format":"date","nullable":true}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer","format":"int32"}},"required":["message","code"]}}}} ```