# Get run failures summary

GET /v3/web-audits/{auditId}/runs/{runId}/reports/failures

Returns a summary of failures for the given run. 
Failures summary includes details for Pre-Audit Actions, On-Page Actions, all found links excluded and starting URLs navigation results.


Endpoint: GET /v3/web-audits/{auditId}/runs/{runId}/reports/failures
Security: API_Key

## Path parameters:

  - `auditId` (integer, required)
    Unique identification number for web audit
    Example: 107239

  - `runId` (integer, required)
    Unique identification number for web audit or journey run
    Example: 33010

## Response 200 fields (application/json):

  - `preAuditActionResults` (object, required)

  - `preAuditActionResults.zeroAndOut` (boolean, required)
    Indicates whether pre-audit actions failed executing in all allocated engine containers.

  - `preAuditActionResults.preAuditActionFailures` (array)
    Pre-audit action results failures. A a set of failed actions with their failure messages.
Uniqueness is determined by the combination of  and .

  - `preAuditActionResults.preAuditActionFailures.auditActionSnapshotId` (integer, required)
    An ID assigned to actions of all types on an audit - unique in the context of an individual run

  - `preAuditActionResults.preAuditActionFailures.failureMessage` (string, required)

  - `onPagesActionResults` (object)
    (Optional) Present if failure/s is/are present for any Page's On-Page Actions execution

  - `onPagesActionResults.totalConfiguredCount` (integer, required)
    Total number of pages configured with On-Page Actions for the Audit run

  - `onPagesActionResults.totalFailedCount` (integer, required)
    Total number of Pages in the Audit run with On-Page Action failures

  - `onPagesActionResults.resultsSample` (array, required)
    A sample of On-Page actions failures.

  - `onPagesActionResults.resultsSample.pageUrl` (string, required)

  - `onPagesActionResults.resultsSample.results` (array, required)

  - `startingUrlResults` (object)
    Provide information for the following use cases:
  One and Out - All starting URLs failed to launch
  One and Out - All links found were excluded by filters

  - `startingUrlResults.failureType` (string, required)
    Possible types:
  -  All conditions must be met:
    1. Number of scanned pages matches number of starting URLs
    2. Scan limit is higher than number of scanned pages
    3. At least 1 link has been excluded.
  -  Flag indicating if all starting Urls failed navigation. 
    Navigation resulted in status codes:
     - zero
     - 403 
     - 500+
    Details for this data is available from the page summary pages endpoint
  -  Flag indicating if all starting Urls failed navigation but without records.
    Enum: "no_links_scanned_one_and_out", "all_starting_urls_failed_one_and_out", "all_starting_urls_failed_zero_and_out"

  - `startingUrlResults.linksExcludedSample` (array)
    (Optional) Present if failureType is  
A sample of links found from starting URLs that were excluded from the audit.
    Example: ["https://example.com/about"]

  - `startingUrlResults.startingUrlFailures` (array)
    (Optional) Present when  is true

  - `startingUrlResults.startingUrlFailures.statusCode` (integer, required)
    Page HTTP status code

  - `startingUrlResults.startingUrlFailures.pageCount` (integer, required)

  - `startingUrlResults.startingUrlFailures.browserError` (string)
    error produced by browser upon opening the page
    Example: "This site can’t be reached. example.com’s server IP address could not be found. ERR_NAME_NOT_RESOLVED"

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 404 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)