OpenCorporates Company Search

OpenCorporates Company Search searches the global company register by business legal name and returns candidate registry records. Use a candidate’s jurisdiction code and company number if you later run the separate OpenCorporates Company Details service. The Workflow Builder block is OpenCorporates, and its service ID is opencorporates_company_search.

Requirements

Application field	Requirement	Notes
Business legal name	Required	Must be a string.
Formation state	Optional	When it resolves to a US state, the search is limited to that state. When absent or unresolved, the search runs without a jurisdiction filter.

Lendflow always orders the provider search by score. No company number or jurisdiction code is required for this search operation.

API flow

Call Enrich Business Credit Application.
Set provider to opencorporates_company_search. This service has no provider-specific request options.
Optionally include stage_id; when supplied, it must be a valid underwriting workflow-stage UUID for the application.
Treat {"data":{"onqueue":true}} as queue acceptance, not a completed search.
Poll Get Commercial Data with services[]=opencorporates_company_search.

{
  "provider": "opencorporates_company_search",
  "stage_id": "6ff8f7f6-1eb3-3525-be4a-3932c805afed"
}

Data	API response path
Stored provider response	`commercial_data.opencorporates.company_search`
Lifecycle message	`statuses.opencorporates.company_search`
Stored request	`request_data.opencorporates.company_search`

The API queues a background job. The provider GET request completes inside that job, and Lendflow stores the query parameters after obfuscating the API token, the provider response, and the HTTP status.

Data Orchestration availability and flow

OpenCorporates Company Search is not included in the current Data Orchestration service catalog. The Workflow Builder block can display and run the service in an underwriting workflow, but a Data Orchestration template cannot select OpenCorporates Company Search as a service step.

What the service returns

Response area	Meaning
`results.companies`	Candidate registry records, each wrapped in a `company` object.
Company identity	Name, company number, and jurisdiction code used to identify the registry record.
Company status	Incorporation and dissolution dates, entity type, inactive flag, and current registry status when available.
Source and links	Registry and OpenCorporates links plus source metadata when supplied.
Pagination	Current page, page size, total pages, and total candidate count.

Representative response

{
  "api_version": "0.4",
  "results": {
    "companies": [
      {
        "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",
          "opencorporates_url": "https://opencorporates.com/companies/us_de/3677166"
        }
      }
    ],
    "page": 1,
    "per_page": 30,
    "total_pages": 1,
    "total_count": 1
  }
}

Response attributes

Attribute	Type	Meaning	Possible values or units	When returned
`api_version`	String	OpenCorporates response API version.	Provider version text.	On the current provider response.
`results.companies`	Array	Candidate registry records.	Zero or more `{ company }` wrappers.	On a successful search.
`results.companies[].company.name`	String	Company name on the registry record.	Registry text.	For each candidate.
`results.companies[].company.company_number`	String	Company identifier within the jurisdiction.	Registry identifier; preserve leading zeroes.	For each candidate.
`results.companies[].company.jurisdiction_code`	String	OpenCorporates registry jurisdiction.	Country or country-subdivision code such as `us_de`.	For each candidate.
`results.companies[].company.incorporation_date`	String or null	Reported incorporation date.	`YYYY-MM-DD` or `null`.	When available.
`results.companies[].company.dissolution_date`	String or null	Reported dissolution date.	`YYYY-MM-DD` or `null`.	When available.
`results.companies[].company.company_type`	String or null	Registry entity type.	Registry-controlled text or `null`.	When available.
`results.companies[].company.inactive`	Boolean or null	Whether OpenCorporates marks the company inactive.	`true`, `false`, or `null` when unavailable.	When supplied.
`results.companies[].company.current_status`	String or null	Current registry status.	Registry-controlled text or `null`.	When available.
`results.companies[].company.registered_address_in_full`	String or null	Provider-formatted registered address.	Address text or `null`.	When available.
`results.companies[].company.opencorporates_url`	String or null	Link to the OpenCorporates company page.	HTTPS URL or `null`.	When available.
`results.page`, `results.per_page`, `results.total_pages`, `results.total_count`	Number	Provider pagination and result totals.	Non-negative integers; page values are normally positive.	On the current search response.

The provider can return additional company and source fields beyond this representative example. Those fields remain raw OpenCorporates data unless Lendflow documents them separately.

Errors and statuses

Missing business_legal_name fails validation before the provider request.
Missing or unresolved formation_state does not fail the search; Lendflow omits jurisdiction_code.
An inactive or invalid API token, provider HTTP failure, or unavailable integration causes the queued job to fail.
A successful response with results.companies: [] means no company matched. It is not a transport failure.
Success means Lendflow stored the search response. It does not verify the selected company or retrieve full KYB details.

FAQ

Is formation state required?

No. When Lendflow can resolve it, the state narrows the search to a U.S. jurisdiction. Otherwise, the request runs without a jurisdiction filter.

Does Company Search return full KYB details?

No. It returns candidate registry records. Use the selected jurisdiction_code and company_number with the separate OpenCorporates Company Details service for the full record.

Can this service run in Data Orchestration?

No. It is not in the current Data Orchestration service catalog.

What does an empty companies array mean?

It means the provider request succeeded but returned no candidate companies for the search.