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.

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:

{
  "provider": "opencorporates_company_search"
}

Then run Company Details with the selected identifiers:

{
  "provider": "opencorporates",
  "options": {
    "jurisdiction_code": "us_de",
    "company_number": "3677166"
  }
}

Send both requests through Enrich Business Credit Application, then poll 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`

OpenCorporates is not included in the current Data Orchestration service catalog.

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

{
  "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

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.

Does this guide include Officer Search?

No. Officer Search is a separate KYC Workflow Builder block.

Can this service run in Data Orchestration?

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