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
| Action | Description | Listed price |
|---|---|---|
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. | Billed per request at your plan's rates |
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. | 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/officersInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. A person's or company's name. Matched loosely on its words; quote nothing. At least 2 characters. At most 200 characters. |
jurisdiction | string | Only this jurisdiction, as OpenCorporates codes it: gb, us_de, us_ca, ... Matches ^[A-Za-z]{2}(_[A-Za-z]{2})?$. |
excludeInactive | boolean | Leave out inactive roles or companies. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
officerId | string | OpenCorporates' id for this role record. |
officerUrl | string | — |
name | string | The officer's name as the registry records it. |
position | string | null | The role, such as director, president, agent or manager. |
inactive | boolean | Whether the role has ended. |
companyName | string | — |
companyUrl | string | — |
companyNumber | string | The company's number in its registry. |
jurisdictionCode | string | OpenCorporates' jurisdiction code, such as us_de or gb. |
jurisdiction | string | null | The jurisdiction's name, such as Delaware (US) |
companyStatus | string[] | The company's labels on the row, such as inactive, branch or nonprofit. |
startDate | string | null | When the role began, as the page shows it, such as 13 Oct 2023. |
endDate | string | null | When 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/companiesInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. A person's or company's name. Matched loosely on its words; quote nothing. At least 2 characters. At most 200 characters. |
jurisdiction | string | Only this jurisdiction, as OpenCorporates codes it: gb, us_de, us_ca, ... Matches ^[A-Za-z]{2}(_[A-Za-z]{2})?$. |
excludeInactive | boolean | Leave out inactive roles or companies. |
pages | integer | How 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:
| Field | Type | Description |
|---|---|---|
name | string | — |
url | string | — |
companyNumber | string | — |
jurisdictionCode | string | — |
jurisdiction | string | null | — |
inactive | boolean | — |
status | string[] | The row's labels, such as inactive, branch or nonprofit. |
currentStatus | string | null | The registry status OpenCorporates classes the row with, such as active, dissolved or merged. |
registeredAddress | string | null | — |
previousNames | string[] | Names the company was previously or alternatively known as. |
trademarks | string[] | Trademarks the row lists for the company, the first few of its registrations. |
startDate | string | null | Incorporation date, when the row shows one. |
endDate | string | null | Dissolution 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.
SEC EDGAR
SEC EDGAR filings: look up filers by name, including insiders who file Forms 3, 4 and 5; full-text search of every filing since 2001 by words, filer, form type and date, with each hit's filer and subject companies, form, dates and document link; and a filer's profile, addresses, former names and recent filings by CIK.
USPTO
USPTO Patent Public Search: US granted patents, published applications and OCR'd historic patents, searched by inventor, assignee or any Patent Public Search query, with title, inventors, applicant and assignee, filing and publication dates, application number, CPC and IPC classes and page count.