> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sila.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a crawl

> GET /v1/crawls/{id} returns status, stats, and discovery results.

`GET https://api.sila.sh/v1/crawls/{id}`

## Response 200

```json theme={null}
{
  "id": "…",
  "url": "https://example.com",
  "limit": 100,
  "status": "completed",
  "phase": "done",
  "stopReason": null,
  "error": null,
  "stats": { "pagesStored": 42, "pagesFailed": 1, "renderedPages": 3, "creditsUsed": 54, "uncrawledCandidates": 0 },
  "discovery": {
    "type": "sitemap",
    "sitemapsFetched": true,
    "urlsTruncated": false,
    "sitemapUrls": [],
    "llmsSources": [{ "url": "…", "etag": null, "lastModified": null, "contentHash": "…", "changed": true, "sectionCount": 10 }],
    "removedUrls": [],
    "totalCandidates": 43
  },
  "createdAt": "…", "startedAt": "…", "completedAt": "…", "expiresAt": "…"
}
```

| Field | Values |
| - | - |
| `status` | `queued`, `running`, `canceling`, `canceled`, `completed`, `failed` |
| `phase` | `discovering`, `crawling`, `done` |
| `stopReason` | `null`, `limit`, `credits_exhausted`, `canceled`, `circuit_breaker` |
| `discovery.type` | `sitemap`, `llms-txt`, `both` |

`stats.uncrawledCandidates` counts URLs Sila found but did not crawl. It can be above `0` on a crawl that finished normally (`stopReason: null`): it also includes links found during link discovery that were never crawled, for example when a safety cap stopped the discovery early.

`discovery` is `null` until discovery finishes. Pages and errors expire 14 days after completion (`expiresAt`).

Crawls that belong to another workspace return `404 not_found`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.