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

# OpenCorporates KYB

## OpenCorporates KYB

OpenCorporates KYB searches company registries and retrieves a selected company's incorporation, status, address, officer, filing, and industry information. The **OpenCorporates** Workflow Builder block supports:

| Service | Service ID | Purpose |
| - | - | - |
| Company Search | `opencorporates_company_search` | Finds candidate companies from the application business name and jurisdiction. |
| Company Details | `opencorporates` | Retrieves the full record for a selected jurisdiction code and company number. |

Officer Search belongs to the separate KYC block and is documented in [OpenCorporates Officer Search](/api-docs/docs/opencorporates-officer-search).

## Requirements

### Company Search

| Application field | Requirement | Notes |
| - | - | - |
| Business legal name | Required | Used to search for candidate companies. |
| Business address | Optional | Used to derive a jurisdiction filter when possible. |

### Company Details

| Application field | Requirement | Notes |
| - | - | - |
| Jurisdiction code | Conditional | Required from the selected Company Search result. Must contain a two-letter country code and may include a registry subdivision, such as `us_de`. |
| Company number | Conditional | Required from the selected Company Search result. |

## Run OpenCorporates KYB

Run Company Search first:

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

Then run Company Details with the selected identifiers:

```json theme={"system"}
{
  "provider": "opencorporates",
  "options": {
    "jurisdiction_code": "us_de",
    "company_number": "3677166"
  }
}
```

Send both requests through [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application), then poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data).

| Service | Result path | Status path |
| - | - | - |
| Company Search | `commercial_data.opencorporates.company_search` | `statuses.opencorporates.company_search` |
| Company Details | `commercial_data.opencorporates.company_details` | `statuses.opencorporates.company_details` |

<Note>
  OpenCorporates is not included in the current Data Orchestration service catalog.
</Note>

## What the service returns

| Response area | Meaning |
| - | - |
| Company Search `results.companies` | Candidate companies and their registry identifiers. |
| Company Search pagination | Page, page size, total pages, and total candidate count. |
| Company Details `results.company` | Selected company identity, incorporation, registration, and source information. |
| `officers`, `filings`, and `industry_codes` | Registry-linked officers, filing history, and classifications when available. |

## Representative response

```json theme={"system"}
{
  "api_version": "0.4",
  "results": {
    "company": {
      "name": "EXAMPLE BUSINESS LLC",
      "company_number": "3677166",
      "jurisdiction_code": "us_de",
      "incorporation_date": "2019-01-01",
      "dissolution_date": null,
      "company_type": "Limited Liability Company",
      "inactive": false,
      "current_status": "Good Standing",
      "registered_address_in_full": "100 Main Street, Wilmington, DE 19801",
      "officers": [],
      "filings": [],
      "industry_codes": []
    }
  }
}
```

## Response attributes

| Attribute | Type | Meaning | Possible values or units | When returned |
| - | - | - | - | - |
| `results.companies` | Array | Candidate companies returned by Company Search. | Zero or more `{ company }` wrappers. | After Company Search. |
| `results.company.name` | String | Name on the registry record. | Registry text. | For a company result. |
| `results.company.company_number` | String | Company identifier within the jurisdiction. | Registry identifier. | For a company result. |
| `results.company.jurisdiction_code` | String | OpenCorporates registry jurisdiction. | Country or country-subdivision code. | For a company result. |
| `results.company.incorporation_date` | String or null | Reported incorporation date. | `YYYY-MM-DD` in current fixtures. | When available. |
| `results.company.dissolution_date` | String or null | Reported dissolution date. | `YYYY-MM-DD` or `null`. | When available. |
| `results.company.company_type` | String or null | Registry entity type. | Registry-controlled text. | When available. |
| `results.company.inactive` | Boolean | Whether OpenCorporates marks the entity inactive. | `true` or `false`. | When supplied. |
| `results.company.current_status` | String or null | Current registry status. | Registry-controlled text. | When available. |
| `results.company.registered_address` | Object or null | Structured registered address. | Street, locality, region, postal code, and country. | When available. |
| `results.company.officers` | Array | Officers associated with the company record. | Zero or more `{ officer }` wrappers. | In Company Details when available. |
| `results.company.filings` | Array | Registry filings associated with the company. | Zero or more `{ filing }` wrappers. | In Company Details when available. |
| `results.company.industry_codes` | Array | Industry classifications. | Code, description, and code-scheme fields. | In Company Details when available. |
| `results.page` | Number | Current Company Search page. | Positive integer. | In Company Search. |
| `results.total_count` | Number | Number of candidate companies. | Non-negative integer. | In Company Search. |

## Errors and statuses

Company Details does not run without both context values. An empty Company Search is not the same as a request failure. Check the nested Lendflow status separately from `results.companies`. API-token and provider HTTP errors are recorded against the applicable service.

## FAQ

<AccordionGroup>
  <Accordion title="Why must Company Search run first?">
    Company Details requires the jurisdiction code and company number of the intended registry record. Company Search supplies those values.
  </Accordion>

  <Accordion title="Does this guide include Officer Search?">
    No. Officer Search is a separate KYC Workflow Builder block.
  </Accordion>

  <Accordion title="Can this service run in Data Orchestration?">
    It is not included in the current Data Orchestration service catalog.
  </Accordion>
</AccordionGroup>