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

# List a scan's pages

> Lists the pages in one scan run with each page's result, score, and any failure reason.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/scans/{id}/pages
openapi: 3.1.0
info:
  title: ility API
  version: 1.0.0
  description: Read accessibility results and start scans in your ility workspace.
servers:
  - url: https://app.ilitylabs.com
security:
  - apiKey: []
tags:
  - name: Workspaces
  - name: Surfaces
  - name: Domains
  - name: Scans
  - name: Issues
paths:
  /v1/scans/{id}/pages:
    get:
      tags:
        - Scans
      summary: List a scan's pages
      description: >-
        Lists the pages in one scan run with each page's result, score, and any
        failure reason.
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: id
          in: path
        - schema:
            type: integer
            minimum: 1
            default: 1
          required: false
          name: page
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          required: false
          name: limit
          in: query
        - schema:
            type: string
            enum:
              - pending
              - running
              - complete
              - failed
              - skipped
              - all
            default: all
          required: false
          name: status
          in: query
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScanPagesResponse'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ScanPagesResponse:
      type: object
      properties:
        scan_run:
          $ref: '#/components/schemas/ScanRunListItem'
        items:
          type: array
          items:
            $ref: '#/components/schemas/ScanPageResult'
        total:
          type: integer
        counts:
          $ref: '#/components/schemas/ScanPageCounts'
      required:
        - scan_run
        - items
        - total
        - counts
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
        reason:
          type: string
      required:
        - detail
    ScanRunListItem:
      allOf:
        - $ref: '#/components/schemas/ScanRun'
        - type: object
          properties:
            domain_slug:
              type: string
            domain_name:
              type: string
            group_id:
              type:
                - string
                - 'null'
              format: uuid
            surface_id:
              type:
                - string
                - 'null'
              format: uuid
            pages_complete:
              type: integer
              minimum: 0
            pages_total:
              type: integer
              minimum: 0
          required:
            - domain_slug
            - domain_name
            - group_id
            - surface_id
            - pages_complete
            - pages_total
    ScanPageResult:
      type: object
      properties:
        id:
          type: string
          format: uuid
        page_id:
          type: string
          format: uuid
        url:
          type: string
        status:
          type: string
        http_status:
          type:
            - integer
            - 'null'
        issue_count:
          type:
            - integer
            - 'null'
        score:
          type:
            - integer
            - 'null'
        has_blocking:
          type: boolean
        page_group:
          type:
            - string
            - 'null'
        error:
          type:
            - string
            - 'null'
        failure_kind:
          type:
            - string
            - 'null'
        started_at:
          type:
            - string
            - 'null'
          format: date-time
        completed_at:
          type:
            - string
            - 'null'
          format: date-time
        duration_ms:
          type:
            - integer
            - 'null'
      required:
        - id
        - page_id
        - url
        - status
        - http_status
        - issue_count
        - score
        - has_blocking
        - page_group
        - error
        - failure_kind
        - started_at
        - completed_at
        - duration_ms
    ScanPageCounts:
      type: object
      properties:
        total:
          type: integer
        pending:
          type: integer
        running:
          type: integer
        complete:
          type: integer
        failed:
          type: integer
        skipped:
          type: integer
      required:
        - total
        - pending
        - running
        - complete
        - failed
        - skipped
    ScanRun:
      type: object
      properties:
        id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        domain_id:
          type: string
          format: uuid
        engine_id:
          type: string
          format: uuid
        engine_slug:
          type: string
        scan_request_id:
          type: string
          format: uuid
        scope:
          type: string
        status:
          type: string
        trigger_source:
          type: string
        triggered_by_user_id:
          type:
            - string
            - 'null'
        config_snapshot:
          type: object
          additionalProperties: {}
        pages_scanned:
          type:
            - integer
            - 'null'
        pages_failed:
          type:
            - integer
            - 'null'
        issues_found:
          type:
            - integer
            - 'null'
        score:
          type:
            - integer
            - 'null'
        has_blocking:
          type: boolean
        error:
          type:
            - string
            - 'null'
        cancel_requested_at:
          type:
            - string
            - 'null'
          format: date-time
        pause_requested_at:
          type:
            - string
            - 'null'
          format: date-time
        paused_at:
          type:
            - string
            - 'null'
          format: date-time
        started_at:
          type:
            - string
            - 'null'
          format: date-time
        completed_at:
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - workspace_id
        - domain_id
        - engine_id
        - engine_slug
        - scan_request_id
        - scope
        - status
        - trigger_source
        - triggered_by_user_id
        - config_snapshot
        - pages_scanned
        - pages_failed
        - issues_found
        - score
        - has_blocking
        - error
        - cancel_requested_at
        - pause_requested_at
        - paused_at
        - started_at
        - completed_at
        - created_at
        - updated_at
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An ility API key, such as `ilk_1a2b3c4d_…`. Workspace owners create keys
        under Settings → API keys.

````

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