---
title: "Canary tracing for one business (?domain=). The licence holder or owner sees every canary - a harmless variant of the business's own name or street (legal-form punctuation, street-type or direction spelling) given to ONE supplier - with where and when it was seen and the proven feed paths (supplier -> directory, with lag in days); public callers get counts only. Sightings are found by the daily listing monitor and also arrive in /api/v1/changes (section listings, kind canary_seen). Signed (crawlcheck-business-canaries)."
method: GET
path: "/api/v1/business/canaries"
---

# Canary tracing for one business (?domain=). The licence holder or owner sees every canary - a harmless variant of the business's own name or street (legal-form punctuation, street-type or direction spelling) given to ONE supplier - with where and when it was seen and the proven feed paths (supplier -> directory, with lag in days); public callers get counts only. Sightings are found by the daily listing monitor and also arrive in /api/v1/changes (section listings, kind canary_seen). Signed (crawlcheck-business-canaries).

`GET /api/v1/business/canaries`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/v1/business/canaries`
- Auth: none required

## Query parameters

- `domain` string, required

## Response `200`

signed canary record

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `domain` string, nullable
  - `canaries` object[], nullable
    - `id` string, nullable
    - `field` string, nullable
    - `value` string, nullable
    - `supplier` string, nullable
    - `status` string, nullable
    - `planted_at` string, nullable
    - `sightings` object[], nullable
      - `source` string, nullable
      - `first_seen` string, nullable
      - `lag_days` number, nullable
  - `proven_paths` object[], nullable
    - `from` string, nullable
    - `to` string, nullable
    - `proven` string, nullable
    - `canary` string, nullable
    - `lag_days` number, nullable
  - `signature` object, nullable
    - `alg` string, nullable

## Other responses

- `400`: bad domain

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)