---
title: "Find solutions for an error code or pasted message"
method: GET
path: "/api/v1/errors/lookup"
---

# Find solutions for an error code or pasted message

`GET /api/v1/errors/lookup`

## Request

- Base URL: `https://checkwebsitenow.com`
- URL: `https://checkwebsitenow.com/api/v1/errors/lookup`
- Auth: none declared

## Query parameters

- `q` string, required

## Response `200`

Up to five ranked matches

- object
  - `schema_version` string
  - `query` string, required
  - `matches` LookupMatch[], required
    - `slug` string, required
    - `title` string, required
    - `kind` 'http_status' | 'browser_error' | 'dns' | 'tls' | 'connection' | 'redirect' | 'checker_result', required
    - `category` string, required
    - `http_status` integer, nullable
    - `severity` 'info' | 'warning' | 'error', required
    - `summary` string, required
    - `url` string, required
    - `api_url` string, required
    - `score` number, required
    - `match` 'slug' | 'alias' | 'http_status' | 'text' | 'family', required: family: a real browser code without its own guide, answered with its family guide.
    - `visitor_steps` Step[], required
      - `title` string, required
      - `detail` string, required: Backtick-wrapped segments are commands.
      - `platforms` object: Optional per-platform hints: windows, macos, android, ios, chromeos, linux.
    - `owner_steps` Step[], required
      - `title` string, required
      - `detail` string, required: Backtick-wrapped segments are commands.
      - `platforms` object: Optional per-platform hints: windows, macos, android, ios, chromeos, linux.
  - `generic_headline` boolean: True when the text is only a browser headline that several different failures share (for example "This site can't be reached" or "Diese Website ist nicht erreichbar"); matches then list the typical causes. Ask for the code shown under the headline.
  - `site_suggestion` object, nullable: When q is a single service name without a dot (for example "netflix" or "is netflix down"): the curated service, its domain to check and its status page.
    - `domain` string, required
    - `name` string, required
    - `page_url` string, required

## Other responses

- `400`: Missing, too long or invalid q.
- `429`: Request error; never a website verdict.

---

[API](https://skmtc.dev/checkwebsitenow/apis/checkwebsitenow-website-checker.md) · [All operations](https://skmtc.dev/checkwebsitenow/apis/checkwebsitenow-website-checker/llms.txt) · [OpenAPI document](https://skmtc.dev/checkwebsitenow/apis/checkwebsitenow-website-checker/revisions/ef066e74da4b?raw)