---
title: "List sites"
method: GET
path: "/v1/sites"
tags: ["Sites"]
---

# List sites

`GET /v1/sites`

## Request

- Base URL: `https://api.ironfang.com/audit`
- URL: `https://api.ironfang.com/audit/v1/sites`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the sites owned by the authenticated organisation, including their stored audit configuration and complete per-site activity facts. Counts and last audit come from authoritative tenant-scoped queries, independently of history page limits.

## Response `200`

Sites

- SiteList
  - `sites` Site[], required
    - `activity` SiteActivity, required
      - `audits` integer, required
      - `has_capture` boolean, required
      - `last_audit` LastSiteAudit, required
        - `created_at` string, date-time, required
        - `id` string, uuid, required
        - `status` 'created' | 'queued' | 'discovering' | 'capturing' | 'evaluating' | 'finalising_evidence' | 'timestamping' | 'completed' | 'failed' | 'cancelled' | 'partial' | 'quota_blocked', required: quota_blocked is historical: audits the retired plans could not pay for ended there. Audits are now admitted before they are accepted, so none enters it.
      - `open_findings` integer, required
    - `crawl_policy` CrawlPolicy, required
      - `allowed_hosts` string[], nullable, required
      - `exclude_patterns` string[], nullable, required
      - `identity_parameters` string[], nullable, required
      - `ignored_parameters` string[], nullable, required
      - `include_patterns` string[], nullable, required
      - `max_depth` integer, required
      - `max_pages` integer, required
      - `max_response_bytes` integer, required
      - `requests_per_second` integer, required
      - `respect_robots` boolean, required
    - `created_at` string, date-time, required
    - `id` string, uuid, required
    - `name` string, required
    - `organisation_id` string, uuid, required
    - `primary_url` string, required
    - `status` string, required
    - `timezone` string, required

## Other responses

- `401`: Problem response
- `403`: Problem response

---

[API](https://skmtc.dev/ironfang/apis/ironfang-audit-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-audit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-audit-api/revisions/7430deff2cbd?raw)