VisionNet API Monitoring System

All requests must first be Authorized over HTTPS.

Company Monitoring. Allows to get latest changes, list, add or remove companies monitored. Below are listed endpoints with parameters and examples

An account can have one of the two modes of monitoring enabled. Certain parameters and responses differs based on the type in use. Account type can be found out by doing a valid request to any of the endpoints and checking returned root object name. Default monitoring type is Normal Monitoring. To change your monitoring type contact your account manager.

  • Normal Monitoring - Standard monitoring type with list of companies. All alerts will go to the email provided for the account contact.
  • Individual Monitoring - Monitoring list is grouped by emails, where each email has its own list of companies monitored.

NOTE: Most requests handle multiple company values passed(eg. adding multiple companies or getting changes for a particular list of company numbers). Handling multiple companies in a single request is described at the bottom of the document

List monitored companies

https://services.vision-net.ie/cws/1.5/monitoring/company/list?co_num={Number}&co_notes={String}&email={validEmail}
Parameter Type Description
co_num Number Optional. Only returns specified company from the list. To filter by multiple companies in a single request look here
co_notes String Optional. Only returns entries matching notes string. Allows % and _ wildcards.
email String Individual Monitoring Only. Optional. Only returns entries for specified email. Allows % and _ wildcards.

Get company changes

https://services.vision-net.ie/cws/1.5/monitoring/company/changes?co_num={Number}&change_type={Number}&since_date={Date}&co_notes={String}&email={validEmail}
Parameter Type Description
since_date yyyy-MM-dd Required. Changes since date
co_num Number Optional. Only returns changes for specified company. To get changes for multiple specific company numbers look here
change_type Number Optional. Only returns changes of specified type. Multiple types can be requested comma separated.
co_notes String Optional. Get changes only for companies with notes. Allows % and _ wildcards. To test matching companies you can use /list request
email Email String Individual Monitoring Only. Optional. Only returns changes for specified email. Allows % and _ wildcards. To test matching companies you can use /list request

Add companies to the monitoring list

https://services.vision-net.ie/cws/1.5/monitoring/company/add?co_num={Number}&co_notes={String}&email={validEmail}
Parameter Type Description
co_num Number Required. Company number to add to the monitoring list. To add multiple company numbers in single request look here
co_notes String Optional. Notes string to save as company reference
email Email String Individual Monitoring Only. Required. Only returns entry for specified email company.

Remove companies from monitoring list

https://services.vision-net.ie/cws/1.5/monitoring/company/remove?co_num={Number}&email={validEmail}
Parameter Type Description
co_num Number Required. Remove company from monitoring list. To remove multiple company numbers look here
email Email String Individual Monitoring Only. Optional. Removes companies for specified email.

Multiple Company Request

Multiple entries can be processed by using a JSON post body request.

Below array object of company numbers can be used for any normal monitoring requests, and individual monitoring requests that do not require email. Other optional parameters in this case will be empty.

[2321,232445,506985,4532]


Below JSON object can be used to send multiple companies with parameters. co_notes is optional(add request only), and email only required for individual monitoring

[ { "co_num": "123", "co_notes": "test note 1", "email": "email@test.ie" }, { "co_num": "12345", "co_notes": "test note 2", "email": "email1@test.ie" } ]