CRO Open Services
"CRO Open Services" is a RESTful API.
It offers the public a means of integrating Company and Submission data into their applications using simple REST calls.
How it works
Your application, which may be written in Java, C#, Php, Python or any other programming language, will
execute simple GET requests to a RESTful API. Your application will then handle the returned data in whatever way
you wish. Typical examples would be listing company search results, retrieving the details of a company,
or listing all of the documents filed with the CRO for a specified company.
The information supplied by Open Services is the same as the free information currently available on the
CRO Company Search website.
Connections from an application to the Open Services API are rate limited. Connections to the API are restricted to 30 per minute.
Cost
The company and submsision search service is free of charge.
There is an additional pay-per-call feature which allows Customer Account holders
to retrieve submission documents or company print outs as byte streams. For more information, see the section on the
API for Account Holders.
Support
For the free services, programming support to individuals is not available from the CRO, but queries
in relation to incorrect data and faults with the service will be dealt with.
A basic level of competence in at least one programming language is required.
A number of code examples are available.
However, support will be provided to Customer Account holders wishing to
use the document streaming service.
Gaining access
Please see the getting started page and read the
steps required to start using the service.
You will need to complete, scan and email a signed copy of
the Terms and Conditions to the CRO at [email protected].
When the CRO receives this, we will go about setting up access credentials to the API for you. Make sure to fill in all of the fields at the bottom of the form including the email address “for the purposes of communications by CRO”.
This email address will also be used in the access credentials.
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.