Skip to main content
GET
/
datasets
/
companies
/
{companyId}
/
intelligence
Intelligence
curl --request GET \
  --url https://api.tic.io/datasets/companies/{companyId}/intelligence \
  --header 'x-api-key: <api-key>'
[
  {
    "companyIntelligenceType": "createdAsShelfCompany",
    "companyIntelligenceTypeDescription": "<string>",
    "companyIntelligenceSubType": "<string>",
    "companyIntelligenceSubTypeDescription": "<string>",
    "notes": "<string>",
    "notesEn": "<string>",
    "notesSv": "<string>",
    "score": 123,
    "firstSeenAtUtc": "2023-11-07T05:31:56Z",
    "lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
    "externalId": 123,
    "intelligenceNotesType": 123,
    "notesValue1": "<string>",
    "notesValue2": "<string>",
    "notesValue3": "<string>",
    "notesValue4": "<string>",
    "sourceUrl": "<string>"
  }
]

​
Details

This endpoint will return all historical and current intelligence records for a business. Intelligence records are part of our AI Anomaly Detection which highlights discrepancies in data and their significance.

​
Intelligence types

Intelligence records contains information about various discrepancies that we find in data. A record contains a score between 0 and 255 representing the significance of the discrepancy. If the score equals 0 is means it’s just for information while 255 means the discrepancy is very significant. Each intelligence record also comes with a human English text describing the discrepancy called intelligence.notes. List of intelligence.companyIntelligenceType below in the table. Please note that while searching you need to enter the value (Int32) and not the name itself. Value 2,4 and 6 are unused currently. They may appear in search result currently just for testing.
EnumValueDescription
CreatedAsShelfCompany0The company was created as shelf company
SuspectedForQuickLiquidation1The company was seems to be going into “quick liquidation”
AffliatedWithArticle3The company is affiliated with one or multiple articles
SuspectedAddress5The address has earlier been known
PresentOnWarningList7The company is present on certain warning lists
AnnualReportDiscrepancies8One or multiple annual reports contains discrepancies
The intelligence.externalId is used to reference an id containing the origin of the intelligence record. If for example the intelligence record is of type: AnnualReportDiscrepancies (8) it means the external id represents the id of the annual report.

​
Intelligence subtypes

Certain intelligence types have subtypes to further describe what has been found. The intelligence.companyIntelligenceSubType is an enum text to make it easier to filter based on search. List of subtypes. Please note you need to filter by string when using intelligence.companyIntelligenceSubType.
EnumDescription
BS_MISMATCHThe balance sheet doesn’t balance
AGM_TO_LATEThe annual general meeting was held to late
AR_TO_LATEThe annual report was submitted to late
AGM_WRONG_DATESuspected wrong date of annual general meeting date
MISSING_MULTIYEARThe multi-year overview is missing
MISSING_CHANGEEQUITYThe table showing change of equity is missing
WRONG_SIGNATUREDATESignature date (last signature) seems to be wrong
WRONG_EQUITYASSETSRATIOThe given equity asset ratio doesn’t match the calculation
MISSING_AUDITORThe company is passing the thresholds requiring an auditor (check response for mandatory requirement)
DUPLICATEThe annual report is a duplicate for another company
NO_SHARECAPITALThe balance sheet is missing share capital
POSSIBLE_MISSINGASSETS
NEGATIVE_SHARECAPITALThe balance sheet contains negative share capital
NEGATIVE_ASSETSThe balance sheet total assets are negative
MISSING_BS_ASSETSMissing part of the balance sheet (assets)
MISSING_BS_EQUITYMissing part of the balance sheet (equity)
MISSING_RSMissing result sheet
LIQUIDATION_REQUIREDThe company is subject to liquidation requirements
WRONG_SHARECAPITALThe share capital is wrong in the balance sheet
MISSING_NUMBEREMPLOYEESMissing number of employees but required
TAX_PAID_LATETaxes have been paid late
FORBIDDEN_LOANA forbidden loan exists
BS_DISCOURGEDAuditor has discouraged the balance sheet
BS_CONTROLA control balance sheet exists
TAX_AUDITA tax audit has been carried out
SUM_INCORRECTVarious sum records are incorrect
AUDITOR_REMARKSAuditor remarks exists
Check back continuously since we are adding more subtypes.

​
Response and example

This is an example response. Note that you are also getting a source url if it exists which enables you to grab the underlying data for intelligence record.
Example response
[
  {
    "companyIntelligenceType": "annualReportDiscrepancies",
    "companyIntelligenceSubType": "MISSING_MULTIYEAR",
    "notes": "The annual report is missing a multi-year overview
    and the first fiscal year has passed.
    Required by the ruleset company is using.",
    "score": 50,
    "firstSeenAtUtc": "2024-07-22T00:00:00",
    "lastSeenAtUtc": null,
    "lastUpdatedAtUtc": "2024-08-20T15:49:50",
    "externalId": 469448,
    "sourceUrl": "https://api.tic.io/financial-documents/se/469448"
  },
  {
    "companyIntelligenceType": "annualReportDiscrepancies",
    "companyIntelligenceSubType": "MISSING_CHANGEEQUITY",
    "notes": "The annual report is missing changes in equity.
    Required by the ruleset company is using.",
    "score": 100,
    "firstSeenAtUtc": "2024-07-22T00:00:00",
    "lastSeenAtUtc": null,
    "lastUpdatedAtUtc": "2024-08-20T15:49:50",
    "externalId": 469448,
    "sourceUrl": "https://api.tic.io/financial-documents/se/469448"
  }
]

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
companyId
integer<int32>
required

The company id

Response

200 - application/json

OK

​
companyIntelligenceType
enum<string>
Available options:
createdAsShelfCompany,
suspectedForQuickLiquidation,
couldBeFranchise,
affliatedWithArticle,
unknown,
suspectedAddress,
formerChecks,
presentOnWarningList,
annualReportDiscrepancies,
auditorResignation,
registration,
registerChanges,
penaltyFees,
beneficialOwner,
claims,
forfeit,
mentionedInCourtCase
​
companyIntelligenceTypeDescription
string | null
​
companyIntelligenceSubType
string | null
​
companyIntelligenceSubTypeDescription
string | null
​
notes
string | null
​
notesEn
string | null
​
notesSv
string | null
​
score
integer<int32> | null
​
firstSeenAtUtc
string<date-time> | null
​
lastUpdatedAtUtc
string<date-time>
​
externalId
integer<int32> | null
​
intelligenceNotesType
integer<int32> | null
​
notesValue1
string | null
​
notesValue2
string | null
​
notesValue3
string | null
​
notesValue4
string | null
​
sourceUrl
string | null