API FAQ
Frequently asked questions about the Strise Connect API, organized by category.
What’s the purpose of the PDF from sidepanel that I can create without doing a risk assessment of the company (Review)?
We have two types of pdf-reports in the app today. The one you find in sidepanel is a “light-version” (missing some data) and does not contain the checklist or any comments made by the case handler. The sidepanel pdf is often used to get a quick overview of a company before a customer meeting. This pdf is not supported in sandbox or via the api in general as they are not relevant for an onboarding use case.
Is it possible to trigger the sidepanel PDF via the API?
When you do a reviewCompanyCreate you can include an ID-field. This ID is unique for this specific Review and can be used to fetch the pdf-file through the review query:
query ReviewPDF {
review(where: { id: "ea1b3bd8-00bf-4714-b4f7-581d84e278e5" }) {
id
pdf
}
}With this, you will get a Base64 encoded string that represents the file that you can convert into an actual pdf.
How long will the pdf report be available after generation with reviewCompanyCreate?
As long as you have a Review ID, it will be available forever.
Notifications
Where do I configure what e-mail account the report will be sent to if I trigger a ReviewCompanyCreate through the API?
This needs to be configured in the Strise app. Press Team settings, then fill in email address as receiver of all reports that generate in Strise, including the ones created by reviewCompanyCreate.
Triggers
I’m trying to trigger reviewTriggerEventGenerate in the api to test a fetch of events, but all I get in return is “success”: false. What am I doing wrong?
You can select trigger rules in the app. Go to Settings, then Risks and Monitoring, then Add trigger. You can choose as many triggers as you like, but reviewTriggerEventGenerate only considers the first one in our sandbox environment. In our production environment it will consider all triggers.
Screening
If you have a company in between a UBO and a customer, will you automatically screen that company when we do a Review?
In cases where there is a company related to another company we do screen:
- The related company (PEP and sanctions)
- UBOs in the related company (PEP and sanctions)
- Other roles in the related company are screened for Sanctions.
We do not screen:
- Other roles in the related company for PEPs.
Is it possible to change PEP status on a person in Strise?
Not now. This problem is in Discovery phase at the moment with our Product team.
Ownership
Is there an easy way of fetching all owners in N layers upwards doing only one query?
This is not possible to do in one query today without defining the amount of layers you want.
Will Strise say anything about the complexity of an ownership structure?
Strise does not flag or notify about complex ownership structures. We provide you with all data available so that you can consider if you find the ownership structure to be complex or not based on your internal guidelines.
What is the difference between data provided on ownership % via API and in the app?
API: default is to fetch ALL ownerships, regardless of how small the percentage is.
App: The ownership of a company is limited to show “only” ownership above 5%. The 5% ownership limit upwards is set because the organizational structure in publicly listed companies will often have several thousand owners, while it is rare to see shareholders with ownership in thousands of companies. The limitation does not apply for downwards ownership, however.
Review Settings
What does “Legal form” within Review settings actually do?
“Legal form” within Review settings indicates low risk. Meaning that if you choose “Limited company”, this legal form will be considered as low risk in Review, while all other legal forms will be considered as high risk.
How often do you update EU’s black list and FATF’s blacklist?
We update these daily. We remove countries when they are removed from the lists, the same way we add new countries when they’re added to the lists. If you consider countries that are removed from these lists to still be high risk, you need to add these manually as high risk countries in the app.
What countries are defined as tax paradise?
See the Tax paradise settings in the app under Settings, then Review settings.
What NACE codes do you consider to have a high risk of AML?
See the High risk NACE codes settings in the app.
A case handler starts a Review in the app, makes some notes in the Review but doesn’t finish. If we then trigger a generated Review through the API, will this contain the case handler’s notes?
No. A Review state is divided and the execution (start till end) of a Review is limited to the one user that started it. A Review can not be shared before it’s done, and then it’s no longer editable.
Flags
What flags do you have in Strise?
Strise surfaces flags such as Risky-industry and high-risk-owner. For a complete overview, contact your Strise representative.
What is your threshold for a considerable change in number of employees and/or revenue?
For detailed thresholds on employee changes and revenue changes, contact your Strise representative.
Can we change the criticality on flags in Strise?
This is not available yet. But we are working on improving flags and there will be more functionality that allows you to adjust this yourself through the API.
Is it possible to choose what flags we want to see?
Right now it’s all or nothing. We are working on improving flags, and being able to choose which ones you want to see and not is a part of this work.
When we receive flags over the API indicating ‘Risky-industry’ or ‘high-risk-owner,’ is that triggered by the countries and industry codes defined on the wiki page? Or from our settings in the app?
Flags are compared to risky countries and industry codes defined on the Flags wiki page.
Sanctions
If a customer in our portfolio has a sanctioned business owner, will this appear as a flag on the company?
Here you need to fetch sanction flags on all nodes that you want to screen. The sanction field on the specific company that you fetch today is only for the company, not including any owners or other roles.
Do you mirror settings for fuzzy name matching from the portal in the API?
Yes.
API General
Is it possible to do labelling/tags via the API?
No, not today.
Is it possible to set a granular risk on NACE codes? Ex. a scale between 1-5?
Not today. We are working on a solution for this to be possible via the API long term.
EntityLike
In an EntityLike you get a list with address and one list with countries. Will we always see 100% overlap between the addresses in these two lists?
The intention with the countries field is to gather all countries connected to the specific entity and present it in one place. In theory this means that an entity can have several addresses in different countries. In the Nordics, you will often have overlap between Countries and ADDRESS. For Nordic entities, address will be the most reliable source for geographical risk.
Private Individuals
What data will we get with the FREG-integration: “privat uten hjemmel”?
This allows for creation of private individuals with FREG backed data (+ updates from the registry). However, the registry-backed calculation of beneficial owners from family relationships requires access to those relationships — which FREG considers to be confidential data not available through the privat uten hjemmel.
What data will we get with the FREG-integration: “offentlig og privat virksomhet med hjemmel”?
This allows for creation of private individuals with FREG backed data (+ updates from the registry). And registry-backed calculation of beneficial owners based on family relationships.
CountryRelationship
How do you define CITIZENSHIP versus NATIONALITY?
This is used to separate between these datapoints if they are available. E.g. A person is born in Sweden, so Nationality: Sweden, but he/she lives in Norway and also has a Norwegian Citizenship, so Citizenship: Norway. You can have multiple citizenships, but nationality is usually defined as your origin/family ties.
AMS
What keywords are used in your AMS search?
See the AMS Keywords documentation for details.
For additional questions, refer to the Connect API documentation or contact tech@strise.ai.