---
title: "List the team's secure links to a company"
description: "The secure links your team has created to the company's report, newest first: when each was created and when it expires (or expired, or was revoked), who created it, and how it has been used: how many times the report was opened, from how many addresses, when last, and how many times an annual report in it was opened. The links themselves are given once, when they are created: only a hash of their secret is kept. A secure link is also one of the team's orders (GET /orders)."
url: https://docs.tic.io/api-lens/companies/list-the-teams-secure-links-to-a-company
lastmod: 2026-11-15T18:06:31.776Z
---

# List the team's secure links to a company

The secure links your team has created to the company's report, newest first: when each was created and when it expires (or expired, or was revoked), who created it, and how it has been used: how many times the report was opened, from how many addresses, when last, and how many times an annual report in it was opened. The links themselves are given once, when they are created: only a hash of their secret is kept. A secure link is also one of the team's orders (GET /orders).

```http
GET https://lens-api.tic.io/companies/{id}/secure-links
```

**Authentication:** API key in the `x-api-key` header.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | integer | yes | Internal company ID |

## Responses

### 200

The team's secure links to the company

```json
[
  {
    "secureLinkId": 123,
    "issuedAtUtc": "2026-01-15T10:30:00Z",
    "expiresAtUtc": "2026-01-15T10:30:00Z",
    "isActive": true,
    "createdByUserId": 123,
    "visits": 123,
    "visitors": 123,
    "lastVisitedAtUtc": "2026-01-15T10:30:00Z",
    "annualReportsOpened": 123
  }
]
```

- Lists the secure links your team has created to the company, newest first.
- **For each link:**
  - `secureLinkId`;
  - when it was created (`issuedAtUtc`);
  - when it expires or expired (`expiresAtUtc`; a revoked link expired when it was revoked);
  - `isActive` (whether it opens now);
  - `createdByUserId` (null when an API key created it);
  - how it has been used: `visits` (how many times the report was opened), `visitors` (from how many addresses), `lastVisitedAtUtc` (when last; null when it has not been opened) and `annualReportsOpened` (how many times an annual report in it was opened).
- **The links themselves are not listed:** a link is given once, by [Create a secure link](/api-lens/companies/create-a-secure-link-to-a-company-report).
