---
title: "Field-by-field audit of every listing found for one business (?domain=) against its truth record: each difference is a named finding (MARKED_CLOSED, PHONE_DIFFERS, NAME_DIFFERS, STREET_DIFFERS, ADDRESS_ON_SERVICE_AREA_BUSINESS, CITY_OUTSIDE_SERVICE_AREA, ZIP_DIFFERS, WEBSITE_DIFFERS, PHONE_MISSING, WEBSITE_MISSING, ADDRESS_MISSING, DUPLICATE_LISTING) with both values and a severity, plus the values directories disagree on with each other. Public audits use the site's own record; the licence holder adds the Business Profile and ?fresh=1. Signed (crawlcheck-business-audit)."
method: GET
path: "/api/v1/business/audit"
---

# Field-by-field audit of every listing found for one business (?domain=) against its truth record: each difference is a named finding (MARKED_CLOSED, PHONE_DIFFERS, NAME_DIFFERS, STREET_DIFFERS, ADDRESS_ON_SERVICE_AREA_BUSINESS, CITY_OUTSIDE_SERVICE_AREA, ZIP_DIFFERS, WEBSITE_DIFFERS, PHONE_MISSING, WEBSITE_MISSING, ADDRESS_MISSING, DUPLICATE_LISTING) with both values and a severity, plus the values directories disagree on with each other. Public audits use the site's own record; the licence holder adds the Business Profile and ?fresh=1. Signed (crawlcheck-business-audit).

`GET /api/v1/business/audit`

## Request

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

## Query parameters

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

## Response `200`

crawlcheck-business-audit

- object, nullable
  - `kind` string, nullable
  - `v` number, nullable
  - `domain` string, nullable
  - `access` string, nullable
  - `truth_used` object, nullable
    - `name` string, nullable
    - `phones` string[], nullable
    - `street` unknown
    - `zip` unknown
    - `service_area_business` boolean, nullable
    - `places` string[], nullable
  - `listings` object[], nullable
    - `source` string, nullable
    - `url` string, nullable
    - `matched_by` string[], nullable
    - `prints` object, nullable
      - `name` string, nullable
      - `phone` string, nullable
      - `address` string, nullable
      - `website` string, nullable
    - `verdict` string, nullable
    - `findings` object[], nullable
      - `code` string, nullable
      - `severity` string, nullable
      - `field` string, nullable
      - `listing_says` string, nullable
      - `business_says` string, nullable
  - `across` object, nullable
    - `phones` object[], nullable
      - `value` string, nullable
      - `in` string[], nullable
  - `counts` object, nullable
    - `listings` number, nullable
    - `correct` number, nullable
    - `differs` number, nullable
    - `wrong` number, nullable
    - `findings` 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 lookups 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)