---
title: "The truth record for one business (?domain=): name, phone, address or service area, hours, website and categories, each with every first-party statement of it (the site's structured data and tel: links; the linked Google Business Profile for the licence holder), whether they agree, and which value the record takes. A conflict is never resolved silently. Public answers are built from the site alone; the licence holder adds the profile and ?fresh=1. Signed (crawlcheck-business-truth)."
method: GET
path: "/api/v1/business"
---

# The truth record for one business (?domain=): name, phone, address or service area, hours, website and categories, each with every first-party statement of it (the site's structured data and tel: links; the linked Google Business Profile for the licence holder), whether they agree, and which value the record takes. A conflict is never resolved silently. Public answers are built from the site alone; the licence holder adds the profile and ?fresh=1. Signed (crawlcheck-business-truth).

`GET /api/v1/business`

## Request

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

## Query parameters

- `domain` string, required
- `fresh` '1'

## Response `200`

crawlcheck-business-truth

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `domain` string, nullable
  - `built_at` string, nullable
  - `access` string, nullable
  - `business_kind` string, nullable
  - `counts` object, nullable
    - `agree` number, nullable
    - `conflict` number, nullable
    - `one_source` number, nullable
    - `absent` number, nullable
    - `reported` number, nullable
  - `fields` object, nullable
    - `phone` object, nullable
      - `status` string, nullable
      - `value` object, nullable
        - `display` string, nullable
        - `digits` string, nullable
      - `taken_from` string, nullable
      - `distinct_values` number, nullable
      - `statements` object[], nullable
        - `value` string, nullable
        - `key` string, nullable
        - `from` string, nullable
        - `where` string, nullable
  - `rule` string, nullable
  - `sources` object, nullable
    - `site` object, nullable
      - `read` boolean, nullable
      - `url` string, nullable
      - `status` number, nullable
      - `business_nodes` number, nullable
    - `profile` object, nullable
      - `linked` boolean, nullable
  - `changes` number, nullable
  - `sha256` unknown
  - `signature` object, nullable
    - `v` number, nullable
    - `alg` string, nullable
    - `kid` unknown

## Other responses

- `400`: no or bad domain
- `404`: opted out
- `429`: too many new records from this address this hour

---

[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)