https://github.com/ph-7/companieslookup
:office: Simple and fast tool to find companies from Companies House database (with their Company Number or Company Name).
https://github.com/ph-7/companieslookup
companies-house companies-house-api companieshouse companieshouse-api companieshouse-lookup company-lookup console lookup php php-7 search-companies-house uk-companies-lookup uk-companies-search uk-company-lookup
Last synced: 8 months ago
JSON representation
:office: Simple and fast tool to find companies from Companies House database (with their Company Number or Company Name).
- Host: GitHub
- URL: https://github.com/ph-7/companieslookup
- Owner: pH-7
- Created: 2017-01-21T22:13:46.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-01-23T18:12:27.000Z (almost 9 years ago)
- Last Synced: 2025-04-09T20:03:38.582Z (8 months ago)
- Topics: companies-house, companies-house-api, companieshouse, companieshouse-api, companieshouse-lookup, company-lookup, console, lookup, php, php-7, search-companies-house, uk-companies-lookup, uk-companies-search, uk-company-lookup
- Language: PHP
- Homepage: https://github.com/pH-7/CompaniesLookup
- Size: 568 KB
- Stars: 12
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CompaniesLookup
Simple and fast tool to find companies (from their *Company Number* or *Company Name*).
I realized there was no such console tools for finding a company from [Companies House](https://www.gov.uk/government/organisations/companies-house) database (similar to the *Unix whois command* for finding the domain names' details).
## Steup
* Be sure PHP 7.0 or higher is installed
* Install Composer (https://getcomposer.org)
* Then run:
```bash
$ composer install
```
* Rename `.env.example` to `.env`
```bash
$ mv .env.example .env
```
* Request your Companies House API key => https://developer.companieshouse.gov.uk/developer/applications
* Open the file (with your favourite text editor)
```bash
$ nano .env
```
* Add the Companies House API Key between the double quote `"` `"`
* Change the permissions of the `companies` bash file (if you use the bash shortcut file)
```bash
$ chmod u+x ./companies
```
* Run the script:
```bash
$ ./companies
```
OR
```bash
php bin/companies companies:search
```
#### Example to find HSBC company
With the Company Name:
```bash
$ ./companies HSBC
```
Or with the Company ID:
```bash
$ ./companies 06388542
```
* Enjoy!
## Requirements
* PHP 7.0 or higher
* [Composer](https://getcomposer.org)
* [Companies House API key](https://developer.companieshouse.gov.uk/developer/signin)
## About me
I'm **Pierre-Henry Soria**, Software Engineer (love that!) and also passionate about marketing and e-businesses.
## Where to contact me?
You can by email at **pierrehenrysoria+github [[AT]] gmail [[D0T]] com**
## License
Under [General Public License 3](http://www.gnu.org/licenses/gpl.html) or later.