VisionNet API PEP Check

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.2/monitoring/company/list?co_num={Number}&co_notes={String}&email={validEmail}
ParameterTypeDescription
co_numNumberOptional. Only returns specified company from the list. To filter by multiple companies in a single request look here
co_notesStringOptional. Only returns entries matching notes string. Allows % and _ wildcards.
emailStringIndividual Monitoring Only. Optional. Only returns entries for specified email. Allows % and _ wildcards.

Get company changes

https://services.vision-net.ie/cws/1.2/monitoring/company/changes?co_num={Number}&change_type={Number}&since_date={Date}&co_notes={String}&email={validEmail}
ParameterTypeDescription
since_dateyyyy-MM-ddRequired. Changes since date
co_numNumberOptional. Only returns changes for specified company. To get changes for multiple specific company numbers look here
change_typeNumberOptional. Only returns changes of specified type. Multiple types can be requested comma separated.
co_notesStringOptional. Get changes only for companies with notes. Allows % and _ wildcards. To test matching companies you can use /list request
emailEmail StringIndividual 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.2/monitoring/company/add?co_num={Number}&co_notes={String}&email={validEmail}
ParameterTypeDescription
co_numNumberRequired. Company number to add to the monitoring list. To add multiple company numbers in single request look here
co_notesStringOptional. Notes string to save as company reference
emailEmail StringIndividual Monitoring Only. Required. Only returns entry for specified email company.

Remove companies from monitoring list

https://services.vision-net.ie/cws/1.2/monitoring/company/remove?co_num={Number}&email={validEmail}
ParameterTypeDescription
co_numNumberRequired. Remove company from monitoring list. To remove multiple company numbers look here
emailEmail StringIndividual 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" } ]