Getting details of a single company or business name

API definition

The API definition for getting company details is available at https://services.cro.ie/cws/help/operations/company

URL

The URL for getting the details for one company or business name is:

 https://services.cro.ie/cws/company/{COMPANY_NUM}/{COMPANY_BUS_IND}?format={FORMAT}&htmlEnc={HTMLENC}

Getting the details of a company or business name returns one Company object.

Specifying Values

The values combined here form the unique identifer for a company or business name. Therefore, both values are required.

Value	Description
company_num	The Company or Business name number
company_bus_ind	The company/business name indicator. Set to C for a company, or B for a business name
format	Optional parameter allowing you to specify JSON as the return format. Include &format=json in the query string to receive JSON data. Alternatively set a Header value Content-type: application/json
htmlEnc	Optional parameter allowing you to specify html codes for certain characters. For example, & would be returned instead of &. Include &htmlEnc=1 in the query string to receive html encoding.

Uses

To get the details of one company, both the company number and the company/bus indicator are required. For example, to bring back the details for a business name, number 412545, this is the URL:

 https://services.cro.ie/cws/company/412545/b

You may test this method by visiting the company details test page.

Eircodes

Around mid-August 2015 (date to be confirmed), any eircodes being recorded by the CRO against companies on the register will be made available through the https://services.cro.ie/cws/companies and https://services.cro.ie/cws/company. A new eircode field will be added to the Company object returned by these queries. To allow users to prepare for this change, a new Company test object is available to download via the test api's https://services.cro.ie/cws/companiestest (multiple company search) and https://services.cro.ie/cws/companytest (single company search). The company test object is the same as the company object except it also includes an eircode field.