---
title: "Queue an immediate scan of a domain (counts as 5 requests)"
method: POST
path: "/domains/{id}/rescan"
---

# Queue an immediate scan of a domain (counts as 5 requests)

`POST /domains/{id}/rescan`

## Request

- Base URL: `https://www.domainlab.app/api/v1`
- URL: `https://www.domainlab.app/api/v1/domains/{id}/rescan`
- Auth: HTTP bearer

10-minute cooldown between scans.

## Path parameters

- `id` integer, required

## Response `202`

Scan queued: { ok, domain_id, domain_name, queued_at }

## Other responses

- `401`: Missing or invalid API key
- `403`: Account lacks API access (no active subscription or trial)
- `404`: NOT_FOUND
- `409`: MONITORING_DISABLED: enable monitoring first
- `429`: Rate limit or monthly quota exceeded. Respect the Retry-After header. code is RATE_LIMITED (short-lived) or MONTHLY_QUOTA_EXCEEDED (resets next period).
- `502`: SCAN_START_FAILED

---

[API](https://skmtc.dev/domainlab/apis/domain-lab-api.md) · [All operations](https://skmtc.dev/domainlab/apis/domain-lab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domainlab/apis/domain-lab-api/revisions/5dade951c661?raw)