ghazanfarmir/laravel-companies-house

This the Laravel Service Provider package to access CompaniesHouse API within your Laravel application.

Thursday, July 26, 2018
by GhazanfarMir
Repository
1 Watchers
3 Stars
384 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
8 Versions
55 % Grown

The README.md

Laravel Companies House

, _(*1)

This Laravel Package implements an API client for the Companies House REST API. It can be used to look up information about companies registered in the United Kingdom. As of July 2016, this API is described by Companies House as a "beta service." More information about this free API can be found on the Companies House API website., _(*2)

Please note, this package is still under development and isn't ready for production yet. Once ready, I will remove this warning; so keep looking at this space., _(*3)

Installation

To install, use the following to pull the package via Composer., _(*4)

composer require ghazanfarmir/laravel-companies-house

Now register the Service Provider in config/app.php, _(*5)

'providers' => [

    ...

    GhazanfarMir\CompaniesHouse\CompaniesHouseServiceProvider::class,
],

And also add the alias to the same file., _(*6)

'aliases' => [

    ...

    'CompaniesHouse' => GhazanfarMir\CompaniesHouse\Facades\CompaniesHouse::class,
],

Finally publish the config file., _(*7)

php artisan vendor:publish

How to use?

use GhazanfarMir\CompaniesHouse\Facades\CompaniesHouse;

Search

CompaniesHouse::search()->all('Ebury');
CompaniesHouse::search()->companies('Ebury');
CompaniesHouse::search()->officers('Ebury');
CompaniesHouse::search()->disqualified_officers('Ebury');

Companies

CompaniesHouse::company('07086058'); // returns an object
CompaniesHouse::company('07086058')->get();
CompaniesHouse::company('07086058')->registered_office_address();
CompaniesHouse::company('07086058')->officers();
CompaniesHouse::company('07086058')->insolvency();
CompaniesHouse::company('07086058')->establishments();
CompaniesHouse::company('07086058')->registers(); // returns 404
CompaniesHouse::company('07086058')->excemptions();

Charges

CompaniesHouse::charges('07086058')->all();
CompaniesHouse::charges('07086058')->find(chargesId);

Filing History

CompaniesHouse::filingHistory('07086058')->all();
CompaniesHouse::filingHistory('07086058')->find('MzE4MjE3NzM2MGFkaXF6a2N4');

Configuration

Obtaining the CompaniesHouse API Key

You will need to register an application with CompaniesHouse by visiting https://developer.companieshouse.gov.uk/developer/applications.
then get API Key which can be used within your Laravel Application in config/companies.php.