> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lendflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FMCSA Company Info

## FMCSA Company Info

FMCSA Company Info retrieves US Department of Transportation registration, operating authority, insurance, inspection, crash, and carrier information for a business. The **FMCSA Company Info** Workflow Builder block exposes the `fmcsa` service for business entities.

## Requirements

| Application field | Requirement | Notes |
| - | - | - |
| Business legal name | Conditional | Required when a USDOT number is unavailable. |
| Business address city and state | Optional | Recommended to improve company matching. |
| USDOT number | Optional | Uses the stored carrier identifier when available. |

## Run FMCSA Company Info

1. Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application).
2. Set `provider` to `fmcsa`.
3. Include the applicable underwriting `stage_id` when required by the workflow.
4. Confirm that the response contains `data.onqueue: true`.
5. Poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=fmcsa`.

```json theme={"system"}
{
  "provider": "fmcsa"
}
```

The request is asynchronous. The result appears at `commercial_data.fmcsa`, the latest lifecycle message appears at `statuses.fmcsa`, and the stored request appears at `request_data.fmcsa`.

## Run FMCSA Company Info in Data Orchestration

FMCSA is available in Data Orchestration.

1. In the Lendflow Dashboard, open **Builders > Data Orchestration**.
2. Add the FMCSA service to a template, connect its outcomes, then save and publish the template.
3. Execute the template with [Execute Data Orchestration](/api-reference/data-orchestration/execute-data-orchestration).
4. Monitor the run with [List Data Orchestration Logs](/api-reference/data-orchestration/list-data-orchestration-logs).

## What the service returns

| Response area | Meaning |
| - | - |
| `company_info.usdot information` | USDOT identifier, registration status, entity type, and filing dates. |
| `company_info.company information` | Legal name, DBA, addresses, telephone, D-U-N-S number, and power units. |
| `company_info.carrier operation` | Interstate or intrastate operating classification. |
| `company_info.operation classification` | Authorized-for-hire, private, government, and other classifications. |
| `company_info.cargo carried` | Cargo categories marked by FMCSA. |
| `company_info.inspections` and `company_info.crashes` | Safety inspection, out-of-service, and crash counts. |
| `detailed_info.authority_types` | Broker, common, and contract authority statuses. |
| `detailed_info.insurance` | Insurance amounts on file and required by category. |

## Representative response

```json theme={"system"}
{
  "company_info": {
    "usdot information": {
      "entity type": "CARRIER",
      "usdot number": "2644260",
      "usdot status": "ACTIVE"
    },
    "company information": {
      "legal name": "EXAMPLE TRANSPORT LLC",
      "power units": "1"
    },
    "carrier operation": {
      "interstate": "X"
    }
  },
  "detailed_info": {
    "authority_types": {
      "common": {
        "status": "ACTIVE",
        "application_pending": "NO"
      }
    },
    "insurance": {
      "bipd": {
        "on_file": "$750,000",
        "required": "$750,000"
      }
    }
  }
}
```

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `company_info.usdot information.usdot number` | String | FMCSA USDOT identifier. | Numeric text. | When a carrier record is found. |
| `company_info.usdot information.usdot status` | String | Current registration status. | Provider text such as `ACTIVE`. | When available. |
| `company_info.usdot information.entity type` | String | FMCSA entity classification. | Provider text such as `CARRIER`. | When available. |
| `company_info.company information.power units` | String | Number of reported power units. | Numeric text. | When reported. |
| `company_info.carrier operation` | Object | Operating scopes; selected values use `X`. | Keys are provider-controlled. | When available. |
| `company_info.operation classification` | Object | Operating classifications; selected values use `X`. | Keys are provider-controlled. | When available. |
| `company_info.cargo carried` | Object | Cargo categories; selected values use `X`. | `X` or `null` in the current fixture. | When available. |
| `detailed_info.authority_types.*.status` | String | Authority status for the named authority type. | Provider text such as `ACTIVE`, `NONE`, or `NOT AUTHORIZED`. | When available. |
| `detailed_info.insurance.*.on_file` | String | Insurance amount or status on file. | Currency text or provider text such as `NO`. | When available. |
| `detailed_info.insurance.*.required` | String | Required insurance amount or status. | Currency text or provider text such as `NO`. | When available. |

## Errors and statuses

`statuses.fmcsa` is a Lendflow lifecycle message, not an FMCSA finding. `Started` means the asynchronous request is pending, and `Success` means Lendflow stored the provider response. A response containing `error`, including `Failed to retrieve company info`, marks the service and any waiting orchestration entry as failed.

## FAQ

<AccordionGroup>
  <Accordion title="Is a USDOT number required?">
    No. Lendflow sends it when available and otherwise uses the business name and location for matching.
  </Accordion>

  <Accordion title="Does Success mean the carrier is authorized?">
    No. `Success` describes request completion. Review the USDOT and authority statuses in the provider result.
  </Accordion>

  <Accordion title="Can this service run in Data Orchestration?">
    Yes. FMCSA is included in the current Data Orchestration service definition.
  </Accordion>
</AccordionGroup>