All requests must first be Authorized and must use the HTTP GET method over HTTPS. Results are encoded int UTF-8.
This call allows you to view a report on a company or business(RBN). It includes relevant company information based on below 4 report types:
| Report Type | Comment | When Available |
|---|---|---|
| BASIC | Free company verification report. Very limited data. Also available for RNB(Registered Business Name/Solo Trader) | Immediately after incorporation |
| FULL | Similar to a CRO report, with company details, secretary, directors and Mortgages & Charges. Also available for RNB | Immediately after incorporation |
| SHAREHOLDER | Contains the immediate Shareholders. See also the UBO report for full shareholder tree. | Approximately 8 months old |
| CREDIT | Contains everything from BASIC, FULL and SHAREHOLDER, plus Balance Sheet, Credit Score, Credit Limit, and Profit & Loss and turnover when filed. RBN version available in PDF only, based on owners negative findings only(using CCI report databases). No financial data is available for RBN. | Approximately 20 months old |
Availability note:
First Annual Return: Each company must file their first annual return 6 months after incorporation. They have two months to comply. Once that B1 Annual Return has been added to VisionNet, we process the Shareholders from the document, which can take a week or two. Once that data returns, approximately 8 months after incorporation, the SHAREHOLDER report becomes available. No accounts / financial statements are included with the first Annual Return.
Second Annual Return: For most companies, they file their first set of accounts with their second Annual Return. This means that the CREDIT report becomes available at approximately 20 months old.
https://api.vision-net.ie/cws/2.4/company/{{COMPANY_NUM}}/{{COMPANY_BUS_IND}}/{{REPORT_TYPE}}?format={{FORMAT}}&htmlEnc={{HTMLENC}}&email={{EMAIL@DOMAIN.COM}}&allDirectors={{ALL_DIRECTORS}}&userRef={{USER_REF}}&nationality={{NATIONALITY}}&anacredit={{ANACREDIT}}
| Parameter | Type | Description |
|---|---|---|
| COMPANY_NUM | Positive Integer | The Company Number or Registered Business Number in question |
| COMPANY_BUS_IND | C or B | C) Company B) Registered Business Name |
| REPORT_TYPE | empty or BASIC(default), FULL, CREDIT or SHAREHOLDER | If not supplied we will return a basic company report for the company. If FULL then we return a chargeable company report which includes NACE Codes, Director Details and Mortgages & Charges details. If CREDIT then we return a CREDIT report which includes everything from the FULL report, plus a Credit Score between 0 and 100, recommended Credit Limit, Balance Sheet, Profit & Loss and Shareholders details (where available). If SHAREHOLDER then we return the latest available Shareholder section of the Annual Return. |
| format | XML, JSON or PDF | Return the results in XML (default) or JSON format. PDF format is available for Company(FULL, CREDIT, SHAREHOLDER) and Business(FULL) reports and is the same as available on the Vision-net.ie website. |
| htmlEnc | 0 or 1 | If set to one, then String fields will be encoded in HTML format. For XML this parameter is forced to 1. For example, ampersands will be encoded as & |
| userRef | String | Optionally record a User Reference for tracking usage. |
| String (valid email) | Optional. If requested Credit Report is not available but can be ordered - error code 406 is returned. By passing email parameter with email address, it will be ordered and emailed when ready. It will also be available by this endpoint. | |
| allDirectors | true or false | Optional. Return all directors including previous. Default value is false |
| nationality | true or false | Optional. Adds information about nationality, EEA residency and occupation for directors if such information is available. Applicable for FULL, CREDIT or SHAREHOLDER report types. Default value is false |
| anacredit | true or false | Optional. Returns extra anacredit related data on FULL or CREDIT reports as in Lookup Tables. Default value is false |
XSD company schema file for companies is normalised for all 4 report types.
XSD business schema file for business report BASIC and FULL. CREDIT is available only as PDF. No Shareholders for businesses are available