---
title: "Get audit pages with filters"
method: POST
path: "/audit/get_audit_pages"
tags: ["Audit"]
---

# Get audit pages with filters

`POST /audit/get_audit_pages`

## Request

- Base URL: `https://api.foudroyer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.foudroyer.com/audit/get_audit_pages`
- Auth: HTTP bearer

Retrieves audit pages with optional filter by issues and pagination (page, page_size). User must own the website associated with the audit.

## Request body

- AuditGetAuditPagesInputDto
  - `audit_id` string, required: Unique identifier of the audit
  - `issues` string[]: Filter pages that have at least one of these issues
  - `page` number: Page number (1-based)
  - `page_size` number: Number of items per page

## Response `200`

List of audit pages with pagination metadata

- AuditGetAuditPagesOutputDto
  - `pages` AuditPageEntity[], required: List of audit pages matching the filters
    - `id` string, required: Unique identifier of the page
    - `fk_audit_id` string, required: Audit ID the page belongs to
    - `url` string, required: Page URL
    - `status_code` number, nullable, required: HTTP status code
    - `content_length` number, nullable, required: Response content length in bytes
    - `crawl_error_reason` string, nullable, required: Reason when crawl failed
    - `meta_title` string, nullable, required: Meta title from the page
    - `meta_description` string, nullable, required: Meta description from the page
    - `canonical_url` string, nullable, required: Canonical URL from the page
    - `meta_robots` string, nullable, required: Meta robots value
    - `h1` string[], nullable, required: H1 headings found on the page
    - `h2` string[], nullable, required: H2 headings found on the page
    - `h3` string[], nullable, required: H3 headings found on the page
    - `h4` string[], nullable, required: H4 headings found on the page
    - `h5` string[], nullable, required: H5 headings found on the page
    - `h6` string[], nullable, required: H6 headings found on the page
    - `hreflang` object[], nullable, required: Hreflang alternate links
      - `lang` string
      - `href` string
    - `json_schema` object, nullable, required: JSON-LD schema from the page
    - `internal_links` string[], nullable, required: Internal links found on the page
    - `external_links` string[], nullable, required: External links found on the page
    - `crawled_at` string, date-time, nullable, required: When the page was crawled
    - `crawl_depth` number, nullable, required: Crawl depth from root
    - `is_orphan` boolean, required: Whether the page is orphan (not linked from other crawled pages)
    - `issues` string[], required: Issues detected on the page
    - `created_at` string, date-time, required: When the page record was created
    - `updated_at` string, date-time, required: When the page record was last updated
  - `total` number, required: Total number of items matching the filters
  - `page` number, required: Current page number (1-based)
  - `page_size` number, required: Number of items per page
  - `total_pages` number, required: Total number of pages
  - `has_next` boolean, required: Whether there is a next page
  - `has_previous` boolean, required: Whether there is a previous page

---

[API](https://skmtc.dev/foudroyer/apis/foudroyer-api.md) - [All operations](https://skmtc.dev/foudroyer/apis/foudroyer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/foudroyer/apis/foudroyer-api/revisions/5b917c67e013?raw)