List documents for a company
curl --request GET \
--url https://lens-api.tic.io/companies/{id}/documents \
--header 'x-api-key: <api-key>'import requests
url = "https://lens-api.tic.io/companies/{id}/documents"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://lens-api.tic.io/companies/{id}/documents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://lens-api.tic.io/companies/{id}/documents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://lens-api.tic.io/companies/{id}/documents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://lens-api.tic.io/companies/{id}/documents")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://lens-api.tic.io/companies/{id}/documents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"pdfFile": {
"id": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"isPdfViewable": true,
"requiresDownload": true
},
"additionalFiles": [
{
"id": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"isPdfViewable": true,
"requiresDownload": true
}
],
"financialReportMetadata": {
"arrivalDate": "2023-11-07T05:31:56Z",
"registrationDate": "2023-11-07T05:31:56Z",
"periodStart": "2023-11-07T05:31:56Z",
"periodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"isConsolidatedAccounts": true,
"isExchange": true,
"isSustainabilityReport": true,
"isElectronic": true,
"sequenceNumber": 123,
"receiptNumber": 123,
"ruleset": "<string>",
"setupFormCode": "<string>",
"caseNumber": 123,
"caseYear": 123,
"software": "<string>",
"auditor": "<string>",
"ce_ProposalForDividend": 123,
"iso4217CurrencyCode": "<string>",
"code": "<string>",
"annualGeneralMeetingDate": "2023-11-07T05:31:56Z",
"lastSignatureDate": "2023-11-07T05:31:56Z",
"auditorFullName": "<string>",
"auditCompanyName": "<string>",
"hasAuditorRemark": true,
"reportSoftwareMetaTag": "<string>",
"reportSoftwareVersionMetaTag": "<string>",
"reportApplicationName": "<string>",
"reportAuditReportHashMetaTag": "<string>",
"reportOriginatorMetaTag": "<string>",
"reportAuditorMetaTag": "<string>",
"auditorSoftwareMetaTag": "<string>",
"auditorSoftwareVersionMetaTag": "<string>",
"auditorApplicationName": "<string>",
"auditorReportHashMetaTag": "<string>",
"auditorOriginatorMetaTag": "<string>",
"hasMultiYearOverview": true,
"hasChangeOfEquity": true,
"hasNumberOfEmployees": true,
"hasProfitOrResultNotAccountedFor": true,
"hasSRFMentions": true,
"hasFARMentions": true,
"aboveCalenderYearIncomeWith": 123,
"companyFinancialReportError": [
{
"companyFinancialReportErrorId": 123,
"externalId": 123,
"errorType": 123,
"errorSource": "<string>",
"errorDescription": "<string>",
"errorValue": "<string>",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z"
}
],
"companyFinancialReportMention": [
{
"companyFinancialReportMentionId": 123,
"externalId": 123,
"mentionType": 123,
"mention": "<string>",
"externalId2": 123,
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z"
}
],
"companyFinancialReportSignature": [
{
"companyFinancialReportSignatureId": 123,
"givenName": "<string>",
"lastName": "<string>",
"role": "<string>",
"description": "<string>",
"signatureDate": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z"
}
],
"companyDividend": [
{
"companyDividendId": 123,
"companyId": 123,
"arrivalDate": "2023-11-07T05:31:56Z",
"accountingPeriodStart": "2023-11-07T05:31:56Z",
"accountingPeriodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"isConsolidatedAccounts": true,
"generalMeetingDate": "2023-11-07T05:31:56Z",
"dividendDate": "2023-11-07T05:31:56Z",
"dividendTypeDescription": "<string>",
"dividendDescription": "<string>",
"dividendAmount": 123,
"dividendCurrencyCode": "<string>",
"firstSeenAtUtc": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
"caseNumber": 123,
"caseYear": 123
}
]
},
"receivedReportMetadata": {
"arrivalDate": "2023-11-07T05:31:56Z",
"periodStart": "2023-11-07T05:31:56Z",
"periodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"caseNumber": 123,
"caseYear": 123,
"ceasedDateInAdacta": "2023-11-07T05:31:56Z",
"ceasedReasonInAdacta": "<string>",
"terminationDate": "2023-11-07T05:31:56Z"
},
"bolagsverketMetadata": {
"documentDate": "2023-11-07T05:31:56Z",
"originalDocumentType": "<string>"
},
"intelligence": [
{
"companyIntelligenceId": 123,
"linkToCompanyId": 123,
"linkToPersonId": 123,
"companyIntelligenceTypeDescription": "<string>",
"companyIntelligenceSubType": "<string>",
"companyIntelligenceSubTypeDescription": "<string>",
"companyIntelligencePolicyId": 123,
"notes": "<string>",
"notesEn": "<string>",
"notesSv": "<string>",
"score": 123,
"firstSeenAtUtc": "2023-11-07T05:31:56Z",
"lastSeenAtUtc": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
"externalId": 123,
"intelligenceNotesType": 123,
"notesValue1": "<string>",
"notesValue2": "<string>",
"notesValue3": "<string>",
"notesValue4": "<string>"
}
],
"shortages": [
{
"companyFinancialReportShortageId": 123,
"arrivalDate": "2023-11-07T05:31:56Z",
"accountingPeriodStart": "2023-11-07T05:31:56Z",
"accountingPeriodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"shortageCode": "<string>",
"shortageDescription": "<string>",
"shortageDetailDescription": {
"code": "<string>",
"title": "<string>",
"description": "<string>"
},
"lastResponseDate": "2023-11-07T05:31:56Z",
"caseClassificationCodes": "<string>",
"firstSeenAtUtc": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
"externalId": 123,
"caseNumber": 123,
"caseYear": 123
}
]
}
]Companies
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.
GET
/
companies
/
{id}
/
documents
List documents for a company
curl --request GET \
--url https://lens-api.tic.io/companies/{id}/documents \
--header 'x-api-key: <api-key>'import requests
url = "https://lens-api.tic.io/companies/{id}/documents"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://lens-api.tic.io/companies/{id}/documents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://lens-api.tic.io/companies/{id}/documents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://lens-api.tic.io/companies/{id}/documents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://lens-api.tic.io/companies/{id}/documents")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://lens-api.tic.io/companies/{id}/documents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"pdfFile": {
"id": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"isPdfViewable": true,
"requiresDownload": true
},
"additionalFiles": [
{
"id": "<string>",
"fileName": "<string>",
"fileType": "<string>",
"isPdfViewable": true,
"requiresDownload": true
}
],
"financialReportMetadata": {
"arrivalDate": "2023-11-07T05:31:56Z",
"registrationDate": "2023-11-07T05:31:56Z",
"periodStart": "2023-11-07T05:31:56Z",
"periodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"isConsolidatedAccounts": true,
"isExchange": true,
"isSustainabilityReport": true,
"isElectronic": true,
"sequenceNumber": 123,
"receiptNumber": 123,
"ruleset": "<string>",
"setupFormCode": "<string>",
"caseNumber": 123,
"caseYear": 123,
"software": "<string>",
"auditor": "<string>",
"ce_ProposalForDividend": 123,
"iso4217CurrencyCode": "<string>",
"code": "<string>",
"annualGeneralMeetingDate": "2023-11-07T05:31:56Z",
"lastSignatureDate": "2023-11-07T05:31:56Z",
"auditorFullName": "<string>",
"auditCompanyName": "<string>",
"hasAuditorRemark": true,
"reportSoftwareMetaTag": "<string>",
"reportSoftwareVersionMetaTag": "<string>",
"reportApplicationName": "<string>",
"reportAuditReportHashMetaTag": "<string>",
"reportOriginatorMetaTag": "<string>",
"reportAuditorMetaTag": "<string>",
"auditorSoftwareMetaTag": "<string>",
"auditorSoftwareVersionMetaTag": "<string>",
"auditorApplicationName": "<string>",
"auditorReportHashMetaTag": "<string>",
"auditorOriginatorMetaTag": "<string>",
"hasMultiYearOverview": true,
"hasChangeOfEquity": true,
"hasNumberOfEmployees": true,
"hasProfitOrResultNotAccountedFor": true,
"hasSRFMentions": true,
"hasFARMentions": true,
"aboveCalenderYearIncomeWith": 123,
"companyFinancialReportError": [
{
"companyFinancialReportErrorId": 123,
"externalId": 123,
"errorType": 123,
"errorSource": "<string>",
"errorDescription": "<string>",
"errorValue": "<string>",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z"
}
],
"companyFinancialReportMention": [
{
"companyFinancialReportMentionId": 123,
"externalId": 123,
"mentionType": 123,
"mention": "<string>",
"externalId2": 123,
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z"
}
],
"companyFinancialReportSignature": [
{
"companyFinancialReportSignatureId": 123,
"givenName": "<string>",
"lastName": "<string>",
"role": "<string>",
"description": "<string>",
"signatureDate": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z"
}
],
"companyDividend": [
{
"companyDividendId": 123,
"companyId": 123,
"arrivalDate": "2023-11-07T05:31:56Z",
"accountingPeriodStart": "2023-11-07T05:31:56Z",
"accountingPeriodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"isConsolidatedAccounts": true,
"generalMeetingDate": "2023-11-07T05:31:56Z",
"dividendDate": "2023-11-07T05:31:56Z",
"dividendTypeDescription": "<string>",
"dividendDescription": "<string>",
"dividendAmount": 123,
"dividendCurrencyCode": "<string>",
"firstSeenAtUtc": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
"caseNumber": 123,
"caseYear": 123
}
]
},
"receivedReportMetadata": {
"arrivalDate": "2023-11-07T05:31:56Z",
"periodStart": "2023-11-07T05:31:56Z",
"periodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"caseNumber": 123,
"caseYear": 123,
"ceasedDateInAdacta": "2023-11-07T05:31:56Z",
"ceasedReasonInAdacta": "<string>",
"terminationDate": "2023-11-07T05:31:56Z"
},
"bolagsverketMetadata": {
"documentDate": "2023-11-07T05:31:56Z",
"originalDocumentType": "<string>"
},
"intelligence": [
{
"companyIntelligenceId": 123,
"linkToCompanyId": 123,
"linkToPersonId": 123,
"companyIntelligenceTypeDescription": "<string>",
"companyIntelligenceSubType": "<string>",
"companyIntelligenceSubTypeDescription": "<string>",
"companyIntelligencePolicyId": 123,
"notes": "<string>",
"notesEn": "<string>",
"notesSv": "<string>",
"score": 123,
"firstSeenAtUtc": "2023-11-07T05:31:56Z",
"lastSeenAtUtc": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
"externalId": 123,
"intelligenceNotesType": 123,
"notesValue1": "<string>",
"notesValue2": "<string>",
"notesValue3": "<string>",
"notesValue4": "<string>"
}
],
"shortages": [
{
"companyFinancialReportShortageId": 123,
"arrivalDate": "2023-11-07T05:31:56Z",
"accountingPeriodStart": "2023-11-07T05:31:56Z",
"accountingPeriodEnd": "2023-11-07T05:31:56Z",
"isInterimReport": true,
"shortageCode": "<string>",
"shortageDescription": "<string>",
"shortageDetailDescription": {
"code": "<string>",
"title": "<string>",
"description": "<string>"
},
"lastResponseDate": "2023-11-07T05:31:56Z",
"caseClassificationCodes": "<string>",
"firstSeenAtUtc": "2023-11-07T05:31:56Z",
"lastUpdatedAtUtc": "2023-11-07T05:31:56Z",
"externalId": 123,
"caseNumber": 123,
"caseYear": 123
}
]
}
]Pro+ tier
Authorizations
Path Parameters
Internal company ID
Response
List of company documents
Available options:
annualReport, interimReport, auditReport, articlesOfAssociation, economicPlan, certificateOfApproval, minutes, statutes, receivedButNotRegistered, receivedButTerminated, other Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
⌘I