opencorporates
Advanced tools
Readme
The OpenCorporates API.
OpenCorporates currently has an issue: their server is sending both a Content-Length header and a Transfer-Encoding: chunked header, which is a violation of the HTTP spec.
node 12's HTTP client flags this error. We are currently awaiting a fix from OpenCorporates.
This module includes all the normal features of the OpenCorporates REST API and adds the following:
items = [{'item': {actual item object}}, {'item': {actual item object}} whereas this module will return items = [{actual item object}, {actual item object}]. So items.forEach(function(item){}) works properly.If you're unsure of how anything works, look at the unit tests, which have examples of all the API calls.
This library now uses async/await from node 8. This means you can await results from opencorporates without callbacks.
await openCorporates.companies.get('us_ca', 'C3268102')
If you're upgrading from version 1, the new module has the following changes:
Stable: npm install opencorporates
Head: npm install fvdm/nodejs-opencorporates
var openCorporates = require('opencorporates')('YOUR_API_TOKEN')
If you do not have an API key, you may omit it, but will have a lower rate limit:
var openCorporates = require('opencorporates')()
API results are converted to camelCase so you can use the keys directly in your app.
Get a single company. Example:
await openCorporates.companies.get('us_ca', 'C3268102')
{
"name": "GOOGLE INC.",
"inactive": false,
"source": {
"publisher": "California Secretary of State",
"url": "http://kepler.sos.ca.gov/",
"retrievedAt": "2014-02-09T19:01:42+00:00"
},
"data": {
"url": "https://opencorporates.com/companies/us_ca/C2474131/data",
"mostRecent": [
{
"datum": {
"id": 2685290,
"title": "Approved US Government Supplier",
"description": null,
"dataType": "GovernmentApprovedSupplier",
"opencorporatesUrl": "https://opencorporates.com/data/2685290"
}
},
{
"datum": {
"id": 4913217,
"title": "Company Address",
"description": "1600 AMPHITHEATRE PKWY, MOUNTAIN VIEW, CA, 940431351",
"dataType": "CompanyAddress",
"opencorporatesUrl": "https://opencorporates.com/data/4913217"
}
}
],
"totalCount": 2
},
"filings": [],
"officers": [],
"companyNumber": "C2474131",
"jurisdictionCode": "us_ca",
"incorporationDate": "2002-11-07",
"dissolutionDate": null,
"companyType": "Foreign Stock",
"registryUrl": "https://businessfilings.sos.ca.gov/frmDetail.asp?CorpID=02474131",
"branchStatus": "branch of an out-of-jurisdiction company",
"currentStatus": "Active",
"createdAt": "2011-09-21T22:27:02+00:00",
"updatedAt": "2014-10-31T06:55:32+00:00",
"retrievedAt": "2014-02-09T19:01:42+00:00",
"opencorporatesUrl": "https://opencorporates.com/companies/us_ca/C2474131",
"previousNames": [],
"agentName": "CORPORATION SERVICE COMPANY WHICH WILL DO BUSINESS IN CALIFORNIA AS CSC - LAWYERS INCORPORATING SERVICE",
"agentAddress": "2710 GATEWAY OAKS DR STE 150N, SACRAMENTO, CA 95833",
"registeredAddressInFull": "1600 AMPHITHEATRE PARKWAY, MOUNTAIN VIEW, CA 94043",
"registeredAddress": {
"locality": null,
"region": null,
"country": "United States",
"streetAddress": "1600 AMPHITHEATRE PARKWAY, MOUNTAIN VIEW, CA 94043",
"postalCode": null
},
"corporateGroupings": [],
"industryCodes": [],
"financialSummary": null,
"homeCompany": null,
"controllingEntity": {
"name": "GOOGLE INC.",
"jurisdictionCode": "us_de",
"companyNumber": null,
"opencorporatesUrl": "https://opencorporates.com/placeholders/691721"
}
}
Search a company.
filters is optional, and can be:
jurisdictionCode e.g. us_ca, nl see the full list of jurisdiction codes. Default is [none/worldwide]order e.g. score. Default is alphabeticperPage e.g. number of results, max. 100. Default is 30 results per pagepage e.g. results page. Default is 1openCorporates.companies.search( 'github', function(err, res){
console.log(JSON.stringify(res, null, 2))
})
This will return:
[
{
"name": "GITHUB, INC.",
"inactive": false,
"source": {
"publisher": "California Secretary of State",
"url": "http://kepler.sos.ca.gov/",
"retrievedAt": "2012-04-03T07:19:16+00:00"
},
"companyNumber": "C3268102",
"jurisdictionCode": "us_ca",
"incorporationDate": "2009-12-31",
"dissolutionDate": null,
"companyType": "Domestic Stock",
"registryUrl": "https://businessfilings.sos.ca.gov/frmDetail.asp?CorpID=03268102",
"branchStatus": null,
"currentStatus": "Active",
"createdAt": "2011-09-17T15:33:31+00:00",
"updatedAt": "2013-10-27T06:27:24+00:00",
"retrievedAt": "2012-04-03T07:19:16+00:00",
"opencorporatesUrl": "https://opencorporates.com/companies/us_ca/C3268102",
"previousNames": [],
"registeredAddressInFull": "548 4TH STREET, SAN FRANCISCO, CA 94107"
},
...many more companies omitted....
]
}
Get available filings for a company.
filters is optional, and can be:
perPage e.g. number of results, max. 100. Default is 30 results per pagepage e.g. results page. Default is 1openCorporates.companies.filings( 'C3268102', console.log )
filters is optional, and can be:
perPage e.g. number of results, max. 100. Default is 30 results per pagepage e.g. results page. Default is 1Get more available data for a company.
filters is optional, and can be:
perPage e.g. number of results, max. 100. Default is 30 results per pagepage e.g. results page. Default is 1openCorporates.companies.filings( 'C3268102', console.log )
Get an officer by ID.
openCorporates.officers.get( '21200360', console.log )
Search officers.
jurisdictionCode e.g. us_ca, nl. Default is [none/worldwide]perPage e.g. number of results, max. 100. Default is 30 results per pagepage e.g. results page. Default is 1openCorporates.officers.search( 'bart simpson' )
From OpenCorporates Corporate Grouping description:
"A CorporateGrouping is a user-curated collection of companies that belong to some human-understand concept of a corporation (which maps to the Wikipedia article about that corporation)."
Get extended data about a corporate grouping, by its name.
openCorporates.corporateGroupings.get( 'bp', console.log )
openCorporates.corporateGroupings.search( 'bp', console.log )
perPage e.g. number of results, max. 100. Default is 30 results per pagepage e.g. results page. Default is 1This module was forked from Franklin van de Meent's original public domain OpenCorporates code.
The fork was created and is maintained by Mike MacCana
FAQs
The OpenCorporates API.
The npm package opencorporates receives a total of 9 weekly downloads. As such, opencorporates popularity was classified as not popular.
We found that opencorporates demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.
Security News
GitHub is susceptible to a CDN flaw that allows attackers to host malware on any public repository.
Security News
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.