---
title: "Start a scan, or return the cached result if under 24 hours old"
method: POST
path: "/api/scan"
---

# Start a scan, or return the cached result if under 24 hours old

`POST /api/scan`

## Request

- Base URL: `https://directindex.org`
- URL: `https://directindex.org/api/scan`
- Auth: one of:
  - none
  - HTTP bearer

## Request body

- object
  - `url` string, required

## Response `200`

Cached summary

## Other responses

- `202`: Scan started
- `429`: Rate limited: 30 new scans per hour per address, or the key's own limit with an API key

---

[API](https://skmtc.dev/directindex/apis/the-direct-index-api.md) · [All operations](https://skmtc.dev/directindex/apis/the-direct-index-api/llms.txt) · [OpenAPI document](https://skmtc.dev/directindex/apis/the-direct-index-api/revisions/c3390f276403?raw)