> ## Documentation Index > Fetch the complete documentation index at: https://docs.tic.io/llms.txt > Use this file to discover all available pages before exploring further. # Intelligence > Gets intelligence records of the company by it's id ### Details This endpoint will return all historical and current intelligence records for a business. Intelligence records are part of our [AI Anomaly Detection](/technology/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. | Enum | Value | Description | | ---------------------------- | ----- | ---------------------------------------------------------- | | CreatedAsShelfCompany | 0 | The company was created as shelf company | | SuspectedForQuickLiquidation | 1 | The company was seems to be going into "quick liquidation" | | AffliatedWithArticle | 3 | The company is affiliated with one or multiple articles | | SuspectedAddress | 5 | The address has earlier been known | | PresentOnWarningList | 7 | The company is present on certain warning lists | | AnnualReportDiscrepancies | 8 | One 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. | Enum | Description | | ------------------------ | ----------------------------------------------------------------------------------------------------- | | BS\_MISMATCH | The balance sheet doesn't balance | | AGM\_TO\_LATE | The annual general meeting was held to late | | AR\_TO\_LATE | The annual report was submitted to late | | AGM\_WRONG\_DATE | Suspected wrong date of annual general meeting date | | MISSING\_MULTIYEAR | The multi-year overview is missing | | MISSING\_CHANGEEQUITY | The table showing change of equity is missing | | WRONG\_SIGNATUREDATE | Signature date (last signature) seems to be wrong | | WRONG\_EQUITYASSETSRATIO | The given equity asset ratio doesn't match the calculation | | MISSING\_AUDITOR | The company is passing the thresholds requiring an auditor (check response for mandatory requirement) | | DUPLICATE | The annual report is a duplicate for another company | | NO\_SHARECAPITAL | The balance sheet is missing share capital | | POSSIBLE\_MISSINGASSETS | | | NEGATIVE\_SHARECAPITAL | The balance sheet contains negative share capital | | NEGATIVE\_ASSETS | The balance sheet total assets are negative | | MISSING\_BS\_ASSETS | Missing part of the balance sheet (assets) | | MISSING\_BS\_EQUITY | Missing part of the balance sheet (equity) | | MISSING\_RS | Missing result sheet | | LIQUIDATION\_REQUIRED | The company is subject to liquidation requirements | | WRONG\_SHARECAPITAL | The share capital is wrong in the balance sheet | | MISSING\_NUMBEREMPLOYEES | Missing number of employees but required | | TAX\_PAID\_LATE | Taxes have been paid late | | FORBIDDEN\_LOAN | A forbidden loan exists | | BS\_DISCOURGED | Auditor has discouraged the balance sheet | | BS\_CONTROL | A control balance sheet exists | | TAX\_AUDIT | A tax audit has been carried out | | SUM\_INCORRECT | Various sum records are incorrect | | AUDITOR\_REMARKS | Auditor 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. ```json Example response theme={null} [ { "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" } ] ``` ## OpenAPI ````yaml get /datasets/companies/{companyId}/intelligence openapi: 3.0.4 info: title: TIC API description: '' version: v1 servers: - url: https://api.tic.io/ security: - ApiKey: [] tags: - name: BolagsverketStatistics - name: Companies - name: Companies_SE_ - name: DocumentDelivery - name: EuropeanCommission - name: FinancialDocuments - name: Finansinspektionen - name: Free - name: ICA - name: ICAStatistics - name: Lists - name: Media - name: Persons - name: Persons_SE_ - name: Properties_SE_ - name: PTSPortings - name: Reseller - name: SearchBankruptciesReports - name: SearchCompanies - name: SearchCompaniesReports - name: SearchCompanyWorkplaces - name: SearchPerson - name: SearchProperties_SE_ - name: SearchVehicles - name: TeamDocumentOrders - name: Teams - name: User - name: Vehicles_SE_ - name: WatchLists paths: /datasets/companies/{companyId}/intelligence: get: tags: - Companies summary: Intelligence description: Gets intelligence records of the company by it's id operationId: Intelligence parameters: - name: companyId in: path description: The company id required: true schema: type: integer format: int32 responses: '200': description: OK content: application/json: schema: type: array items: $ref: >- #/components/schemas/Ormeo_WebAPI_Models_Datasets_Company_CompanyIntelligence_Dto components: schemas: Ormeo_WebAPI_Models_Datasets_Company_CompanyIntelligence_Dto: type: object properties: companyIntelligenceType: $ref: '#/components/schemas/Ormeo_Library_Entities_CompanyIntelligenceType' companyIntelligenceTypeDescription: type: string nullable: true readOnly: true companyIntelligenceSubType: type: string nullable: true companyIntelligenceSubTypeDescription: type: string nullable: true readOnly: true notes: type: string nullable: true notesEn: type: string nullable: true notesSv: type: string nullable: true score: type: integer format: int32 nullable: true firstSeenAtUtc: type: string format: date-time nullable: true lastUpdatedAtUtc: type: string format: date-time externalId: type: integer format: int32 nullable: true intelligenceNotesType: type: integer format: int32 nullable: true notesValue1: type: string nullable: true notesValue2: type: string nullable: true notesValue3: type: string nullable: true notesValue4: type: string nullable: true sourceUrl: type: string nullable: true readOnly: true additionalProperties: false Ormeo_Library_Entities_CompanyIntelligenceType: enum: - createdAsShelfCompany - suspectedForQuickLiquidation - couldBeFranchise - affliatedWithArticle - unknown - suspectedAddress - formerChecks - presentOnWarningList - annualReportDiscrepancies - auditorResignation - registration - registerChanges - penaltyFees - beneficialOwner - claims - forfeit - mentionedInCourtCase type: string securitySchemes: ApiKey: type: apiKey name: x-api-key in: header ````