Company flags are a crucial part of Enins anti-fraud toolbox. We recommend that you use this endpoint to get company flag for a single company.
This will give you all ACTIVE flags for the company, unless lookback_days or lookback_date is used
This endpoint is great to use as part of a onboarding check or similar where you need to check the current status of a company.
https://api.enin.ai/analysis/v1/company/NO917540640/company-flag-compositeNO917540640 is NO + organization number of company or a company_uuidThis will give you
[
{
"uuid": "044b03cb-8da1-50f4-aa96-1514ea6f6a96",
"company": {
"uuid": "f0e01f1e-f977-429f-ac12-0f0418901bfe",
"name": "ENIN AS", // <-- The company in question
"org_nr": "917540640",
"org_nr_schema": "NO",
},
"company_flag": {
"uuid": null,
"company_uuid": "f0e01f1e-f977-429f-ac12-0f0418901bfe",
"company_flag_type_uuid": "9b22fd0a-17e8-4ad5-929e-6840cbd283df", // <-- Connection to the flag type
"flag_date": "2024-06-15T00:00:00",
"flag_context": null,
"flag_end_date": null,
},
"company_flag_type": {
"uuid": "9b22fd0a-17e8-4ad5-929e-6840cbd283df",
"company_flag_type_key": "negative_total_equity", // <-- Flag type
"company_flag_type_description": "When the most recent accounts show a negative total equity",
"default_lookback_days": 1825,
"default_flag_end_days": 1825,
},
},
]
Explanation:
flag_date is the date we know the flag occured, or the earliest possible moment we can fetch the company flag.flag_end_date tells you when a flag has ended. If the flag is currently active flag_end_date will be null.flag_context can sometimes include extra information about the flag. For instance recent_high_risk_event will give you references to the specific event that was categorized as high risk.Other possible query parameters:
lookback_date: YYYY-MM-DD, Default: None, look for active flags back to and including this datelookback_days: Include flags x days into the past. Default is set on a flag type to flag type basis.company_flag_type_identifiers: Only receive flags of a certain type. Send in a comma seperated list.Find all flags that were active 14 days back
https://api.enin.ai/analysis/v1/company/NO917540640/company-flag-composite?lookback_days=14Find all flags that were active on 1st january 2025:
https://api.enin.ai/analysis/v1/company/NO917540640/company-flag-composite?lookback_date=2025-01-01Find all flags with multiple flag types.
https://api.enin.ai/analysis/v1/company/NO917540640/company-flag-composite?company_flag_type_identifiers=recent_high_risk_event,negative_total_equity,beneficial_ownership_change_or_new_beneficial_ownersFor up to date information about the endpoint see Analysis documentation
If you want to see a list of all available company flag types, you can call this endpoint.
https://api.enin.ai/analysis/v1/company-flag-typeThis will give you
[
{
"uuid": "86f288b1-290b-4761-bf30-349d44e6f4eb",
"company_flag_type_key": "fsa_license_epengeforetak",
"company_flag_type_description": "E-pengeforetak",
"app_hidden_flag": false,
"default_lookback_days": 0,
"flag_rank": null,
"persist_flag": true,
"default_flag_end_days": 0,
},
// A list of about 120 flag types
]
And if you have access to the Enin Webportal you can see icons and see more details about all flags: https://app.enin.ai/company/flags