Endpoints to authenticate and generate an Authentication Token.
- API Documentation
- Update EventRules
Global Monitoring (1.0.0)
The Global Monitoring API provides a suite of endpoints to Monitor changes to Company Information. Company changes can be retrieved by creating a Portfolio (a collection of companies) and configuring the eventRules (the criteria in which to trigger a change, e.g. company name changes, limit changes) on the portfolio. When a company in your Portfolio changes to satisfy an eventRule, a notificationEvent will be raised to inform you of the nature of the change. See here for Creditsafe's Global Monitoring capabilities.
The OAS 3.0.4 version of this API specification is provided for trial purposes only. While every effort is made to ensure its accuracy, the OAS 3.1.0 version is the primary managed and maintained specification and is recommended for all integrations and production use.
https://connect.sandbox.creditsafe.com/v1/
https://connect.creditsafe.com/v1/
Request
Endpoint to that lists all the eventRules, their status and parameters based on a portfolio Id, filtered by country. Newly created portfolios are without any notification event rules by default, but you can switch rules on/off per country or on a global basis. There are different rules available for each country due to the different type of change event data that's available. The following GET request lists all the available rules for a portfolio.
- Sandbox server
https://connect.sandbox.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}
- Production server
https://connect.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://connect.sandbox.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'
Shows whether the notification event rule has been enabled for the given portfolio.
The ISO/Alpha 2 format country code for the notification event rule. "XX" is used for global rules that apply to companies from all countries.
A short description of the ruleType
for the notification event rule.
The name for the notification event rule.
Some notification event rules may include input parameters used to tailor the notifications generated to your preference.
Some notification event rules may include input parameters used to tailor the notifications generated to your preference.
Some notification event rules may include input parameters used to tailor the notifications generated to your preference.
[ { "isActive": 0, "ruleCode": 101, "ruleCountryCode": "XX", "ruleType": 4, "ruleTypeName": "Rating band change - 3 input", "name": "International Rating | Reduce by {0} Band(s) OR Less than Band {1}", "param0": "1", "param1": "A", "param2": "A" } ]
Request
Endpoint to update an eventRule in a portfolio. Must provide a portfolio unique identifier and a country code in the URL of the PUT request. The Body of the request must contain the ruleCode
number of the eventRule you want to update, with an isActive
parameter. Some event rules may also contain specific parameters, which can be set with param0
, param1
and param2
. parameters. Get the above information by calling the List All eventRules endpoint.
Important Note
It is recommended that any changes made to the Event Rules
are verified using the List Portfolio Event Rules Endpoint after the PUT call has been made.
To ensure optimal processing efficiency when updating live event rules—whether for removal, addition, or status change—it is best practice to update the entire list of rules in a single operation.
- Sandbox server
https://connect.sandbox.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}
- Production server
https://connect.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://connect.sandbox.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/{countryCode}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '[
{
"ruleCode": 101,
"isActive": 1,
"param0": true,
"param1": "15",
"param2": "10"
},
{
"ruleCode": 1802,
"isActive": 1,
"param0": "10"
},
{
"ruleCode": 1815,
"isActive": 0
}
]'
- Sandbox server
https://connect.sandbox.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/setDefault
- Production server
https://connect.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/setDefault
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://connect.sandbox.creditsafe.com/v1/monitoring/portfolios/{portfolioId}/eventRules/setDefault' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'