> ## 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. # List documents for a company > Returns every document we hold for the company: filed annual reports (with files, signatures, dividends, mentions), Bolagsverket filings, terminated/shortage reports, and any related intelligence flags. Pro+ tier ## OpenAPI ````yaml get /companies/{id}/documents openapi: 3.1.1 info: title: TIC Lens API description: "The TIC Lens API provides programmatic access to company, person, property, vehicle, and order data.\r\n\r\n## Authentication\r\n\r\nAll requests require an API key passed via the `x-api-key` header:\r\n\r\n```bash\r\ncurl -H \"x-api-key: YOUR_API_KEY\" https://lens-api.tic.io/companies/123\r\n```\r\n\r\nAPI keys are managed through the TIC Lens web application under **Settings → API Keys**.\r\n\r\n## Base URL\r\n\r\n| Environment | URL |\r\n|-------------|-----|\r\n| Production | `https://lens-api.tic.io` |\r\n\r\n## Feature Access\r\n\r\nEndpoints are gated by your subscription plan. If your plan does not include a feature, the endpoint will return `403 Forbidden`.\r\n\r\n## Rate Limits\r\n\r\nRate limits are applied per API key. If you exceed the limit, requests will return `429 Too Many Requests`.\r\n\r\n## Response Format\r\n\r\nAll responses are JSON. Null values are omitted from responses.\r\n" version: v1 servers: - url: https://lens-api.tic.io security: - ApiKey: [] tags: - name: Addresses - name: Bolagsverket - name: Brf - name: Companies - name: Documents - name: FlightImages - name: Free - name: Orders - name: OrdersExports - name: PaymentControl - name: PaymentControlImport - name: Persons - name: Properties - name: PublicSearch - name: SearchAutocomplete - name: Sentinel - name: ServingPermits - name: Team - name: Teams - name: Transportstyrelsen - name: Vehicles - name: WatchList paths: /companies/{id}/documents: get: tags: - Companies summary: List documents for a company description: >- Returns every document we hold for the company: filed annual reports (with files, signatures, dividends, mentions), Bolagsverket filings, terminated/shortage reports, and any related intelligence flags. operationId: GetCompanyDocuments parameters: - name: id in: path description: Internal company ID required: true schema: type: integer format: int32 responses: '200': description: List of company documents content: application/json: schema: type: array items: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_CompanyDocument_Dto '404': description: Company not found or not accessible components: schemas: Ormeo_Web_Lens_Models_Companies_CompanyDocument_Dto: type: object properties: id: type: - 'null' - string type: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_CompanyDocumentType pdfFile: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_CompanyDocumentFile_Dto additionalFiles: type: - 'null' - array items: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_CompanyDocumentFile_Dto financialReportMetadata: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_FinancialReportMetadata_Dto receivedReportMetadata: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_ReceivedReportMetadata_Dto bolagsverketMetadata: $ref: >- #/components/schemas/Ormeo_Web_Lens_Models_Companies_BolagsverketDocumentMetadata_Dto intelligence: type: - 'null' - array items: $ref: '#/components/schemas/Ormeo_Library_Dtos_CompanyIntelligence_Dto' shortages: type: - 'null' - array items: $ref: >- #/components/schemas/Ormeo_Library_Dtos_CompanyFinancialReportShortage_Dto additionalProperties: false Ormeo_Web_Lens_Models_Companies_CompanyDocumentType: enum: - annualReport - interimReport - auditReport - articlesOfAssociation - economicPlan - certificateOfApproval - minutes - statutes - receivedButNotRegistered - receivedButTerminated - other type: string Ormeo_Web_Lens_Models_Companies_CompanyDocumentFile_Dto: type: object properties: id: type: - 'null' - string fileName: type: - 'null' - string fileType: type: - 'null' - string isPdfViewable: type: boolean requiresDownload: type: boolean additionalProperties: false Ormeo_Web_Lens_Models_Companies_FinancialReportMetadata_Dto: type: object properties: arrivalDate: type: - 'null' - string format: date-time registrationDate: type: - 'null' - string format: date-time periodStart: type: - 'null' - string format: date-time periodEnd: type: - 'null' - string format: date-time isInterimReport: type: - 'null' - boolean isConsolidatedAccounts: type: - 'null' - boolean isExchange: type: - 'null' - boolean isSustainabilityReport: type: - 'null' - boolean isElectronic: type: - 'null' - boolean sequenceNumber: type: - 'null' - integer format: int32 receiptNumber: type: - 'null' - integer format: int64 ruleset: type: - 'null' - string setupFormCode: type: - 'null' - string caseNumber: type: - 'null' - integer format: int32 caseYear: type: - 'null' - integer format: int32 software: type: - 'null' - string auditor: type: - 'null' - string ce_ProposalForDividend: type: - 'null' - number format: double iso4217CurrencyCode: type: - 'null' - string code: type: - 'null' - string annualGeneralMeetingDate: type: - 'null' - string format: date-time lastSignatureDate: type: - 'null' - string format: date-time auditorFullName: type: - 'null' - string auditCompanyName: type: - 'null' - string hasAuditorRemark: type: - 'null' - boolean reportSoftwareMetaTag: type: - 'null' - string reportSoftwareVersionMetaTag: type: - 'null' - string reportApplicationName: type: - 'null' - string reportAuditReportHashMetaTag: type: - 'null' - string reportOriginatorMetaTag: type: - 'null' - string reportAuditorMetaTag: type: - 'null' - string auditorSoftwareMetaTag: type: - 'null' - string auditorSoftwareVersionMetaTag: type: - 'null' - string auditorApplicationName: type: - 'null' - string auditorReportHashMetaTag: type: - 'null' - string auditorOriginatorMetaTag: type: - 'null' - string hasMultiYearOverview: type: - 'null' - boolean hasChangeOfEquity: type: - 'null' - boolean hasNumberOfEmployees: type: - 'null' - boolean hasProfitOrResultNotAccountedFor: type: - 'null' - boolean hasSRFMentions: type: - 'null' - boolean hasFARMentions: type: - 'null' - boolean aboveCalenderYearIncomeWith: type: - 'null' - integer format: int64 companyFinancialReportError: type: - 'null' - array items: $ref: >- #/components/schemas/Ormeo_Library_Dtos_CompanyFinancialReportError_Dto companyFinancialReportMention: type: - 'null' - array items: $ref: >- #/components/schemas/Ormeo_Library_Dtos_CompanyFinancialReportMention_Dto companyFinancialReportSignature: type: - 'null' - array items: $ref: >- #/components/schemas/Ormeo_Library_Dtos_CompanyFinancialReportSignature_Dto companyDividend: type: - 'null' - array items: $ref: '#/components/schemas/Ormeo_Library_Dtos_CompanyDividend_Dto' additionalProperties: false Ormeo_Web_Lens_Models_Companies_ReceivedReportMetadata_Dto: type: object properties: arrivalDate: type: - 'null' - string format: date-time periodStart: type: - 'null' - string format: date-time periodEnd: type: - 'null' - string format: date-time isInterimReport: type: - 'null' - boolean caseNumber: type: - 'null' - integer format: int32 caseYear: type: - 'null' - integer format: int32 ceasedDateInAdacta: type: - 'null' - string format: date-time ceasedReasonInAdacta: type: - 'null' - string terminationDate: type: - 'null' - string format: date-time additionalProperties: false Ormeo_Web_Lens_Models_Companies_BolagsverketDocumentMetadata_Dto: type: object properties: documentDate: type: - 'null' - string format: date-time originalDocumentType: type: - 'null' - string additionalProperties: false Ormeo_Library_Dtos_CompanyIntelligence_Dto: type: object properties: companyIntelligenceId: type: integer format: int32 linkToCompanyId: type: - 'null' - integer format: int32 linkToPersonId: type: - 'null' - integer format: int32 companyIntelligenceType: $ref: '#/components/schemas/Ormeo_Library_Entities_CompanyIntelligenceType' companyIntelligenceTypeDescription: type: - 'null' - string readOnly: true companyIntelligenceSubType: type: - 'null' - string companyIntelligenceSubTypeDescription: type: - 'null' - string readOnly: true companyIntelligencePolicyId: type: - 'null' - integer format: int32 notes: type: - 'null' - string notesEn: type: - 'null' - string notesSv: type: - 'null' - string score: type: - 'null' - integer format: int32 firstSeenAtUtc: type: - 'null' - string format: date-time lastSeenAtUtc: type: - 'null' - string format: date-time lastUpdatedAtUtc: type: string format: date-time externalId: type: - 'null' - integer format: int32 externalOrigin: $ref: '#/components/schemas/Ormeo_Library_Entities_ExternalOrigin' intelligenceNotesType: type: - 'null' - integer format: int32 notesValue1: type: - 'null' - string notesValue2: type: - 'null' - string notesValue3: type: - 'null' - string notesValue4: type: - 'null' - string additionalProperties: false Ormeo_Library_Dtos_CompanyFinancialReportShortage_Dto: type: object properties: companyFinancialReportShortageId: type: integer format: int32 arrivalDate: type: - 'null' - string format: date-time accountingPeriodStart: type: - 'null' - string format: date-time accountingPeriodEnd: type: - 'null' - string format: date-time isInterimReport: type: - 'null' - boolean shortageCode: type: - 'null' - string shortageDescription: type: - 'null' - string shortageDetailDescription: $ref: >- #/components/schemas/Ormeo_Library_Bolagsverket_Types_BolagsverketTypeFor_915 lastResponseDate: type: - 'null' - string format: date-time caseClassificationCodes: type: - 'null' - string firstSeenAtUtc: type: - 'null' - string format: date-time lastUpdatedAtUtc: type: string format: date-time externalId: type: - 'null' - integer format: int32 externalOrigin: $ref: '#/components/schemas/Ormeo_Library_Entities_ExternalOrigin' caseNumber: type: - 'null' - integer format: int32 caseYear: type: - 'null' - integer format: int32 additionalProperties: false Ormeo_Library_Dtos_CompanyFinancialReportError_Dto: type: object properties: companyFinancialReportErrorId: type: integer format: int32 externalId: type: - 'null' - integer format: int32 errorType: type: - 'null' - integer format: int32 errorSource: type: - 'null' - string errorDescription: type: - 'null' - string errorValue: type: - 'null' - string lastUpdatedAtUtc: type: - 'null' - string format: date-time externalOrigin: $ref: '#/components/schemas/Ormeo_Library_Entities_ExternalOrigin' additionalProperties: false Ormeo_Library_Dtos_CompanyFinancialReportMention_Dto: type: object properties: companyFinancialReportMentionId: type: integer format: int32 externalId: type: - 'null' - integer format: int32 mentionType: type: - 'null' - integer format: int32 mention: type: - 'null' - string externalId2: type: - 'null' - integer format: int32 lastUpdatedAtUtc: type: - 'null' - string format: date-time externalOrigin: $ref: '#/components/schemas/Ormeo_Library_Entities_ExternalOrigin' additionalProperties: false Ormeo_Library_Dtos_CompanyFinancialReportSignature_Dto: type: object properties: companyFinancialReportSignatureId: type: integer format: int32 givenName: type: - 'null' - string lastName: type: - 'null' - string role: type: - 'null' - string description: type: - 'null' - string signatureDate: type: - 'null' - string format: date-time lastUpdatedAtUtc: type: - 'null' - string format: date-time additionalProperties: false Ormeo_Library_Dtos_CompanyDividend_Dto: type: object properties: companyDividendId: type: integer format: int32 companyId: type: integer format: int32 arrivalDate: type: - 'null' - string format: date-time accountingPeriodStart: type: - 'null' - string format: date-time accountingPeriodEnd: type: - 'null' - string format: date-time isInterimReport: type: - 'null' - boolean isConsolidatedAccounts: type: - 'null' - boolean generalMeetingDate: type: - 'null' - string format: date-time dividendDate: type: - 'null' - string format: date-time dividendType: $ref: '#/components/schemas/Ormeo_Library_Entities_DividendType' dividendTypeDescription: type: - 'null' - string dividendDescription: type: - 'null' - string readOnly: true dividendAmount: type: - 'null' - number format: double dividendCurrencyCode: type: - 'null' - string firstSeenAtUtc: type: - 'null' - string format: date-time lastUpdatedAtUtc: type: string format: date-time caseNumber: type: - 'null' - integer format: int32 caseYear: type: - 'null' - integer format: int32 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 Ormeo_Library_Entities_ExternalOrigin: enum: - table_Bolagsverket_Notification - table_Stage_CompanyPersonHistory - table_PRV_Trademark - table_System_SwedishCity - table_FI_Company - table_FI_CompanyPermit - table_ICA_Store - table_Srf_Company - table_FAR_Member - table_Bolagsverket_Document - table_Bolagsverket_Case - table_SalesOrderRow - table_SalesOrder - table_System_UserValidation - table_System_User - table_User - table_TeamInvitation - table_Sweden_CourtDocument - table_PRV_TrademarkImage - table_Bolagsverket_Order - table_SCB_JE - table_SCB_AE - table_Bolagsverket_BeneficialOwnerNotification - table_TeamWatchListTrigger - table_SCB_Foretagsnamn - table_SCB_ExpImp - table_SCB_AstNummer - table_SCB_Konskvot - table_Company - table_Larmtjanst_Object - table_Transportstyrelsen_Person - table_Forsakringskassan_Claim - table_FI_BorsInformationReport - table_Skatteverket_FA_INK - table_Skatteverket_FA_MOMS_AG - table_Skatteverket_KA_PLIGG - table_Skatteverket_SKT_AG - table_Skatteverket_SKT_INK - table_Skatteverket_SKT_MOMS - table_Skatteverket_TF_ANST - table_SPAR_NotificationRecord - table_SPAR_NotificationRecordReference - table_Lantmateriet_InskrivningPerson - table_CompanyCase - table_Bolagsverket_BeneficialOwner - table_Bolagsverket_AnnualReport - table_SPAR_NotificationRecordRelationship - table_Skatteverket_Basinformation - table_PersonRelationship - table_CompanyImport - table_SeaweedFSFile - table_Sweden_CompanyAnnualReport - table_CompanyFinancialReport - table_CompanyAddress - table_CompanyStatus - table_CompanyPerson - table_CompanyRegistration - table_CompanyIntelligence - table_CompanyFinancialDocument - table_CompanyNaming - table_CompanyPurpose - table_CompanyShareCapital - table_CompanyRegisteredOffice - table_KFM_OrderToPayCase - table_PersonAddress - table_PersonName - table_CompanyWorkplaceAddress - table_Lantmateriet_InskrivningAgandeForandring - table_Lantmateriet_InskrivningInteckning - file_Bolagsverket - table_KFM_DebtorSummaryEntityDebt - table_CompanyWorkplaceCompany - table_CompanyDocument - table_FileImport - table_CompanyFinancialReportRegistration - table_Folkhalsomyndigheten_ServingPermit - table_CompanyFinancialReportFile - table_TeamCompanyDocument - table_Bolagsverket_RepresentativeHistory - table_CompanyPersonTemp - table_Lansstyrelsen_Decision - table_Kammarkollegiet_Sanktionsavgift - table_CompanyFinancialReportSummary - table_Lantmateriet_InskrivningAnteckning - table_Property - table_SwishRequest - external_Lantmateriet_RegisterenhetObjektIdentitet - table_SwishRefundResponse - table_LEI_Order - table_Bankgirot_Bankgironumber - table_Person - external_Navet - table_Transportstyrelsen_VehicleSummaryEvent - external_Bolagsverket_Case - table_Ria_AgentLocation - table_PropertyAnnualReportFile type: string Ormeo_Library_Bolagsverket_Types_BolagsverketTypeFor_915: type: object properties: code: type: - 'null' - string title: type: - 'null' - string description: type: - 'null' - string additionalProperties: false Ormeo_Library_Entities_DividendType: enum: - dividendOrdinary - dividendSpecial type: string securitySchemes: ApiKey: type: apiKey name: x-api-key in: header ````