> ## 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.

# Experian Corporate Registrations

## Experian Corporate Registrations

Use this service to retrieve Experian corporate-registration records for a business, including filing jurisdiction, entity type, filing dates, standing, and registered-agent information when available.

## Requirements

| Application field | Requirement | Notes |
| - | - | - |
| Business country | Required | Provide the business country code. This service supports United States business information. |
| Business legal name | Conditional | Required when the application does not already have a Business Identification Number (BIN). |
| Business city | Conditional | Required when the application does not already have a BIN. |
| Business state | Conditional | Required when the application does not already have a BIN. Use the two-letter state code. |
| Business street, ZIP code, telephone, and EIN | Optional | These fields can improve Business Match results when Lendflow must obtain a BIN. |
| Business Identification Number (BIN) | Conditional | Required to run Corporate Registrations. If it is unavailable, Lendflow runs Experian Business Match and uses the result with the highest numeric reliability code. The service does not run if Business Match returns no result. |

## API flow

This service is available through Workflow Builder and the dashboard. It is **not** a Data Orchestration attribute, so a Data Orchestration template cannot run it.

The dashboard starts a manual run with `PUT /api/int/applications/{application_id}/enrich` and provider `experian_corporate_registrations`. This is an internal dashboard route, not a supported public integration endpoint.

To retrieve a completed result through the public API:

1. Call `GET /api/applications/{application_id}/commercial_data` through [Get Commercial Data](/api-reference/workflow-management/get-commercial-data).
2. Pass `services[]=experian_corporate_registrations`.
3. Read the provider result from `data.commercial_data.experian.corporate_registrations`.
4. Use `data.statuses.experian.corporate_registrations` for the latest status, `data.dates.experian_corporate_registrations` for the latest date, and `data.request_data.experian.corporate_registrations` for the stored request.

The dashboard uses these corresponding paths:

| Value | Dashboard data path |
| - | - |
| Response | `commercialData.experian.corporate_registrations` |
| Status | `commercialData.statuses.experian.corporate_registrations` |
| Submitted request | `commercialData.request_data.experian.corporate_registrations` |

The outbound Experian request contains `bin`, `subcode`, and `statusDescriptionDetail: true`.

## Data Orchestration availability

| Capability | Availability |
| - | - |
| Workflow Builder block | Available |
| Manual dashboard run | Available |
| Data Orchestration attribute or prerequisite | Not available |
| Commercial-data retrieval | Available after the service runs |

## What the service returns

| Result area | What it contains | How to interpret it |
| - | - | - |
| `businessHeader` | Identity data for the Experian business associated with the BIN. | Confirm that the record belongs to the intended business. |
| Registration details | Filing jurisdiction, legal name, charter number, dates, entity type, standing, profit classification, and existence term. | Availability depends on the filing jurisdiction. |
| Agent details | Registered-agent name and address. | The agent may be a third party or a person associated with the business. |
| `corporateRegistrationIndicator` | Whether Experian reports corporate-registration information. | `true` means registration data is present; `false` means it is not. |

## Representative response

```json theme={"system"}
{
  "businessHeader": {
    "bin": "000000000",
    "businessName": "SAMPLE INDUSTRIES",
    "address": {"city": "AUSTIN", "state": "TX", "zip": "78701"},
    "customerDisputeIndicator": false
  },
  "stateOfOrigin": "TX",
  "legalName": "SAMPLE INDUSTRIES, LLC",
  "charterNumber": "SAMPLE-CHARTER",
  "originalFilingDate": "2020-04-15",
  "incorporatedDate": "2020-04-15",
  "businessType": "LLC",
  "statusFlag": "A",
  "statusDescription": "Good standing",
  "profitFlag": "Profit",
  "domesticForeignIndicator": "Domestic filing state",
  "corporateRegistrationIndicator": true
}
```

## Response attributes

### Business identity

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `businessHeader.bin` | String | Experian Business Identification Number. | Experian identifier. | When Experian identifies the business. |
| `businessHeader.businessName` | String | Name associated with the matched record. | Business name. | When available. |
| `businessHeader.address` | Object | Address associated with the matched record. | Street, city, state, ZIP, and ZIP extension may appear. | When available. |
| `businessHeader.phone` | String or null | Business telephone number. | Telephone number. | When available; otherwise `null` or absent. |
| `businessHeader.taxId` | String or null | Federal tax identifier in the Experian record. | Nine-digit identifier. | When available; otherwise `null` or absent. |
| `businessHeader.dbaNames` | Array or null | Doing-business-as names. | Array of strings. | When available; otherwise `null` or absent. |
| `businessHeader.customerDisputeIndicator` | Boolean | Whether the business disputed profile information. | `true` or `false`. | When supplied by Experian. |

### Registration and standing

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `stateOfOrigin` | String or null | Filing jurisdiction. | Two-letter state code. | When available. |
| `legalName` | String or null | Legal name on the filing. | Business name. | When available. |
| `charterNumber` | String or null | Charter or registration number. | Jurisdiction-specific identifier. | When available. |
| `originalFilingDate` | String or null | Original filing date. | `YYYY-MM-DD`. | When available. |
| `recentFilingDate` | String or null | Most recent filing date. | `YYYY-MM-DD`. | When available. |
| `incorporatedDate` | String or null | Incorporation date. | `YYYY-MM-DD`. | When available. |
| `businessType` | String or null | Legal structure. | For example, `LLC` or `Corporation`. | When available. |
| `statusFlag` | String or null | Compact registration status. | `A` for active or `I` for inactive. | When available. |
| `statusDescription` | String or null | Detailed standing. | Examples include `Good standing`, `Reinstated`, `Bankruptcy`, `Terminated`, and `Revoked`. | When available. |
| `profitFlag` | String or null | Profit classification. | `Profit`, `Non-profit`, or `Unknown`. | When available. |
| `corporateRegistrationIndicator` | Boolean | Whether registration information is reported. | `true` or `false`. | When supplied by Experian. |

### Term, tax, and agent details

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `existenceTermYears` | Number or null | Length of the charter term. | Years. | When available. |
| `existenceTermDate` | String or null | Date through which the charter is valid. | `YYYY-MM-DD`. | When available. |
| `federalTaxId` | String or null | Federal tax identifier reported on the filing. | Identifier. | When available. |
| `stateTaxId` | String or null | State tax identifier. | Identifier. | When available. |
| `domesticForeignIndicator` | String or null | Relationship to the filing state. | `Domestic filing state` or `Foreign filing state`. | When available. |
| `agentName` | String or null | Registered agent's name. | Name. | When available. |
| `agentAddress` | Object or null | Registered agent's address. | Street, city, state, and ZIP. | When available. |

## Statuses and errors

| Signal | Meaning |
| - | - |
| `Not yet started` | The dashboard has no run for this service. |
| `Started` | The service was queued or is running. |
| `Success` | A provider response was stored. |
| Error message in `data.statuses.experian.corporate_registrations` | The service run failed and the status contains its message. |
| No Business Match result | Lendflow stops before the service request because it could not obtain a BIN. |
| Invalid credentials or subcode | Authentication or request validation fails before a usable result is stored. |

Unavailable provider fields can be `null` or omitted. Use `data.statuses.experian.corporate_registrations`, rather than optional provider fields, to determine whether a run failed.

## FAQ

<AccordionGroup>
  <Accordion title="Does this service require an Experian BIN?">
    Yes. Lendflow automatically runs Experian Business Match when the business does not already have one.
  </Accordion>

  <Accordion title="Can I run Corporate Registrations in Data Orchestration?">
    No. The Workflow Builder block exists, but the current Data Orchestration inventory does not include this service.
  </Accordion>

  <Accordion title="Is an EIN required for Business Match?">
    No. Legal name, city, and state are required. EIN, street, ZIP, and telephone are optional.
  </Accordion>

  <Accordion title="Why are some registration fields null or missing?">
    Filing authorities do not supply every field for every jurisdiction. Lendflow preserves provider nulls and omitted optional fields.
  </Accordion>
</AccordionGroup>