---
title: "List a company's identity links"
method: GET
path: "/api/v1/ackdb/entities/{ref}/links"
tags: ["ackDB"]
---

# List a company's identity links

`GET /api/v1/ackdb/entities/{ref}/links`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/entities/{ref}/links`
- Auth: HTTP bearer

All identity links for a company, addressed by `ref` — an entity id (ULID) OR a domain (e.g. `acme.com`). Pass `?type=` to filter to a single link type.

## Path parameters

- `ref` string, required

## Query parameters

- `type` string

## Response `200`

The company's identity links (all, or filtered to `?type=`)

- object
  - `data` AckdbIdentityLink[], required
    - `entityId` string, required: The entity this link belongs to.
    - `source` string, required: Source system (e.g. slack, stripe).
    - `externalIdType` string, required: Type of external ID (e.g. slack_channel_id).
    - `externalIdValue` string, required: The actual external ID value.
    - `confidence` number, required: Confidence score of the link (0-1). 1.0 = verified.
    - `linkedAt` string, date-time, required: When this identity link was created.

## Other responses

- `404`: No entity matches `ref`

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)