String docs
Site integrations

OpenCorporates

OpenCorporates company-registry records worldwide: officer search by person name, with each role, the company, its jurisdiction and status, and the role's start and end dates; and company search by name, with company number, jurisdiction, status, registered address and previous names.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: opencorporates
  • Version: 1.0.0
  • Reads from: opencorporates.com
ActionDescriptionListed price
officersFind company officers by person name across OpenCorporates' registries worldwide, optionally in one jurisdiction or only active roles: each row is one role (director, president, agent, manager, ...) with the officer's name as filed, the company's name, number, jurisdiction and status labels, and the role's start and end dates. 30 rows a page, in OpenCorporates' order.Billed per request at your plan's rates
companiesFind companies by name across OpenCorporates' registries worldwide, optionally in one jurisdiction or only active ones: name, company number, jurisdiction, status, registered address and previous names. 30 rows a page, in OpenCorporates' order.Billed per request at your plan's rates

officers

Find company officers by person name across OpenCorporates' registries worldwide, optionally in one jurisdiction or only active roles: each row is one role (director, president, agent, manager, ...) with the officer's name as filed, the company's name, number, jurisdiction and status labels, and the role's start and end dates. 30 rows a page, in OpenCorporates' order.

POST https://request.usestring.ai/v1/integrations/opencorporates/officers

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. A person's or company's name. Matched loosely on its words; quote nothing. At least 2 characters. At most 200 characters.
jurisdictionstringOnly this jurisdiction, as OpenCorporates codes it: gb, us_de, us_ca, ... Matches ^[A-Za-z]{2}(_[A-Za-z]{2})?$.
excludeInactivebooleanLeave out inactive roles or companies.
pagesintegerHow many pages of 30 rows to read, from 1. From 1 to 10.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
officerIdstringOpenCorporates' id for this role record.
officerUrlstring—
namestringThe officer's name as the registry records it.
positionstring | nullThe role, such as director, president, agent or manager.
inactivebooleanWhether the role has ended.
companyNamestring—
companyUrlstring—
companyNumberstringThe company's number in its registry.
jurisdictionCodestringOpenCorporates' jurisdiction code, such as us_de or gb.
jurisdictionstring | nullThe jurisdiction's name, such as Delaware (US)
companyStatusstring[]The company's labels on the row, such as inactive, branch or nonprofit.
startDatestring | nullWhen the role began, as the page shows it, such as 13 Oct 2023.
endDatestring | nullWhen the role ended, when it has.

Example

curl https://request.usestring.ai/v1/integrations/opencorporates/officers \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "jennifer pritzker"
  }'

data starts with these rows:

[
  {
    "officerId": "809238627",
    "officerUrl": "https://opencorporates.com/officers/809238627",
    "name": "Colonel (IL) Jennifer N. Pritzker, II ARNG (Retired)",
    "position": "vice president",
    "inactive": true,
    "companyName": "COLONEL (IL) JAMES N. PRITZKER LIBRARY OF THE CITIZEN SOLDIER CORP.",
    "companyUrl": "https://opencorporates.com/companies/us_vt/0436702",
    "companyNumber": "0436702",
    "jurisdictionCode": "us_vt",
    "jurisdiction": "Vermont (US)",
    "companyStatus": ["inactive", "branch", "nonprofit"],
    "startDate": "13 Oct 2023",
    "endDate": "6 Aug 2025"
  },
  {
    "officerId": "606335109",
    "officerUrl": "https://opencorporates.com/officers/606335109",
    "name": "JENNIFER JONES PRITZKER",
    "position": null,
    "inactive": true,
    "companyName": "CEDAR ROAD LLC",
    "companyUrl": "https://opencorporates.com/companies/us_ca/202123510389",
    "companyNumber": "202123510389",
    "jurisdictionCode": "us_ca",
    "jurisdiction": "California (US)",
    "companyStatus": ["branch"],
    "startDate": "19 Aug 2021",
    "endDate": null
  }
]

Requests and billing

  • Requests: 1–2 Web Access requests per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

companies

Find companies by name across OpenCorporates' registries worldwide, optionally in one jurisdiction or only active ones: name, company number, jurisdiction, status, registered address and previous names. 30 rows a page, in OpenCorporates' order.

POST https://request.usestring.ai/v1/integrations/opencorporates/companies

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. A person's or company's name. Matched loosely on its words; quote nothing. At least 2 characters. At most 200 characters.
jurisdictionstringOnly this jurisdiction, as OpenCorporates codes it: gb, us_de, us_ca, ... Matches ^[A-Za-z]{2}(_[A-Za-z]{2})?$.
excludeInactivebooleanLeave out inactive roles or companies.
pagesintegerHow many pages of 30 rows to read, from 1. From 1 to 10.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
namestring—
urlstring—
companyNumberstring—
jurisdictionCodestring—
jurisdictionstring | null—
inactiveboolean—
statusstring[]The row's labels, such as inactive, branch or nonprofit.
currentStatusstring | nullThe registry status OpenCorporates classes the row with, such as active, dissolved or merged.
registeredAddressstring | null—
previousNamesstring[]Names the company was previously or alternatively known as.
trademarksstring[]Trademarks the row lists for the company, the first few of its registrations.
startDatestring | nullIncorporation date, when the row shows one.
endDatestring | nullDissolution date, when the row shows one.

Example

curl https://request.usestring.ai/v1/integrations/opencorporates/companies \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "tawani",
    "jurisdiction": "us_il"
  }'

data starts with these rows:

[
  {
    "name": "1435 WEST JARVIS LLC",
    "url": "https://opencorporates.com/companies/us_il/LLC_03049507",
    "companyNumber": "LLC_03049507",
    "jurisdictionCode": "us_il",
    "jurisdiction": "Illinois (US)",
    "inactive": true,
    "status": ["inactive"],
    "currentStatus": "merged",
    "registeredAddress": "104 S MICHIGAN AVENUE, STE 1120, CHICAGO, IL, 60603",
    "previousNames": ["TAWANI VENTURES LLC"],
    "trademarks": [],
    "startDate": null,
    "endDate": null
  },
  {
    "name": "TAWANI CHARITABLE DISTRIBUTION FUND",
    "url": "https://opencorporates.com/companies/us_il/CORP_62033614",
    "companyNumber": "CORP_62033614",
    "jurisdictionCode": "us_il",
    "jurisdiction": "Illinois (US)",
    "inactive": false,
    "status": ["nonprofit"],
    "currentStatus": "active",
    "registeredAddress": null,
    "previousNames": [],
    "trademarks": [],
    "startDate": null,
    "endDate": null
  }
]

Requests and billing

  • Requests: 1–2 Web Access requests per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.