---
title: "Check a bot name or website against the directory and scam records"
method: GET
path: "/api/check.json"
---

# Check a bot name or website against the directory and scam records

`GET /api/check.json`

## Request

- Base URL: `https://getbotornot.com`
- URL: `https://getbotornot.com/api/check.json`
- Auth: one of:
  - none
  - HTTP bearer

## Query parameters

- `q` string, required

## Response `200`

Check result

- object
  - `query` string
  - `verdict` 'watchlist_match' | 'documented_bot' | 'both' | 'no_record'
  - `guidance` string
  - `bots` object[]
  - `enforcement_actions` object[]
  - `dfpi_entries` object[]
  - `dfpi_total_matches` integer

## Other responses

- `400`: Missing or too-short q

---

[API](https://skmtc.dev/getbotornot/apis/botornot-public-data-api.md) · [All operations](https://skmtc.dev/getbotornot/apis/botornot-public-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getbotornot/apis/botornot-public-data-api/revisions/c3cc3909775d?raw)