Ongoing Monitoring integration guide
Set up an API integration
Setting up an API integration is the most flexible way of testing our Ongoing Monitoring solutions. You can use your preferred IDE, framework, Postman, etc. using credentials provided by Signicat.
Before you set up an API integration, we recommended that you familiarise yourself with the most common integration use cases and the OpenAPI reference documentation to learn about available endpoints and their properties. You can also view our Test data guide, which contains test data for the data sources by attribute and country.
Using the API
The most basic ongoing monitoring process will consist of the following steps:
- Prerequisites.
- Create a monitor.
- Add an organisation.
- Send organisations to data sources.
- Get changes.
- Get the latest snapshot, if needed.
1. Prerequisites
Before you can start making requests to this API, you need to learn how to connect to it. To do this, follow steps 1-3 in the Connect to Signicat APIs Quick start guide.
2. Create a monitor
Create a Monitor by making an HTTP POST request to the Create monitor endpoint.
3. Add an organisation
Add an organisation to the Monitor by making an HTTP POST request to the Add organisation endpoint.
4. Send organisations to data sources
The system automatically distributes the organisation to the data sources configured for the monitor.
5. Get changes
Get changes, if detected, by making an HTTP GET request to the one of the Changes endpoints. You can retrieve changes by monitorId alone or by monitorId and changeId. The endpoints return paginated lists of detected changes.
Response example
{
"size": 3,
"nextCursor": 2,
"limit": 1000,
"items": [
{
"id": 1,
"referenceKey": "402d1ce2-ce71-4f9b-b252-3fa90fef0de4",
"monitorId": "8a1d17e9-626d-44b0-9eaa-0935bf2c8fe1",
"detected": "2025-09-11T11:27:11.3183971Z",
"created": "2025-09-10T17:27:11.3183975Z",
"changes": [
{
"profile": "screening",
"attribute": "CompanyName",
"action": "Update",
"new": "New Name",
"old": "Previous Name"
},
{
"profile": "screening",
"attribute": "MatchStrength",
"action": "Update",
"new": "100",
"old": "60"
}
]
}
]
}
6. Get the latest snapshot, if needed
Get the latest snapshot, if needed, by making an HTTP GET request to the Get latest organisation snapshot endpoint. The endpoint returns the most recent full snapshot of the organisation's data.
Response example
{
"country": "NOR",
"name": "Organisation Name",
"added": "2025-10-15T08:19:58.9412252Z",
"lastUpdate": "2025-10-16T08:19:58.9412266Z",
"organisationNumber": "12345678",
"operationalStatus": "Active",
"externalId": "1454-15",
"alias": "Organisation Alias",
"legalForm": "Other",
"vatNumber": "12345678",
"email": "example@example.pt",
"registrationDate": "2025-10-15T08:19:58.9412273Z",
"phone": {
"number": "12345678",
"region": "NOR"
},
"addresses": [
{
"type": "Registered",
"startDate": "2025-10-15T08:19:58.9412297Z",
"endDate": "2025-10-17T08:19:58.9412295Z",
"country": "NOR",
"postCode": "postcode",
"postPlace": "postplace",
"street": "Street"
}
],
"industries": [
{
"naceCode": "1234"
}
],
"names": [
{
"name": "Organisation Name",
"type": "Business",
"startDate": "2025-10-15T08:19:58.9412319Z",
"endDate": "2025-10-17T08:19:58.9412318Z"
},
{
"name": "Organisation Name",
"type": "Registered",
"startDate": "2025-10-15T08:19:58.9412323Z",
"endDate": "2025-10-17T08:19:58.9412323Z"
}
],
"screening": {
"matchStrength": 100,
"listType": "SANCTION",
"source": "EU_GLOBAL"
},
"finance": {
"creditRating": {
"description": "description",
"score": "10",
"scoringSystem": "System",
"url": "example.com",
"year": 2025
},
"financials": [
{
"currency": "EUR",
"grossProfit": 12,
"netProfit": 13,
"netProfitAfterTax": 18,
"turnover": 1,
"year": 2024
},
{
"currency": "EUR",
"grossProfit": 30.02,
"netProfit": 31.902,
"netProfitAfterTax": 32.98,
"turnover": 2,
"year": 2023
}
],
"paymentRemarkInfo": {
"numberOfRemarks": 1
}
},
"roles": {
"companies": [
{
"name": "Company",
"roles": [
{
"roleCategory": "Auditor",
"description": "description",
"startDate": "2025-10-15T08:19:58.9412391Z",
"endDate": "2025-10-17T08:19:58.9412389Z"
}
],
"organisationNumber": "12345678"
}
],
"persons": [
{
"address": {
"country": "NOR",
"postCode": "postcode",
"postPlace": "postplace",
"street": "Street"
},
"dateOfBirth": "1985-10-16",
"idNumber": {
"country": "NOR",
"number": "12345",
"type": "National"
},
"name": {
"first": "first",
"middle": "middle",
"last": "last",
"full": "first middle last",
"status": "All"
},
"nationality": "NOR",
"roles": [
{
"roleCategory": "Ceo",
"description": "description",
"startDate": "2025-10-15T08:19:58.9412415Z",
"endDate": "2025-10-17T08:19:58.9412415Z"
}
]
}
],
"others": [
{
"id": "123",
"name": "other",
"roles": [
{
"roleCategory": "Auditor",
"description": "description",
"startDate": "2025-10-15T08:19:58.9412402Z",
"endDate": "2025-10-17T08:19:58.9412401Z"
}
]
}
]
}
}
API reference
Explore our Ongoing Monitoring reference documentation to look up all API endpoints and properties as well as view sample requests and responses.