# Get Tag Inventory page info for specified audit run

POST /v3/web-audits/{auditId}/runs/{runId}/reports/tag-inventory/pages

Endpoint: POST /v3/web-audits/{auditId}/runs/{runId}/reports/tag-inventory/pages
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

## Query parameters:

  - `page` (integer)
    Number of results page of an endpoint with paginated results

  - `size` (integer)

  - `sortBy` (string)
    Enum: "page_url", "final_page_url", "page_load_time", "page_status_code", "final_page_status_code", "tag_instance_count", "unique_tag_count", "broken_tag_count"

  - `sortDesc` (boolean)
    Controls sorting order

## Request fields (application/json):

  - `pageUrl` (object)

  - `pageUrl.filterType` (string, required)
    Enum: "contains", "regex"

  - `pageUrl.filterValue` (string, required)

  - `pageUrl.negated` (boolean)
    Switches from "contains" to "not contains", and from "matches regex" to "does not match regex". Supported only by Page Summary for now

  - `finalPageUrl` (object)

  - `pageTitle` (object)

  - `pageTitle.filterValue` (string, required)
    Page title as displayed by browser
    Example: "ObserveP"

  - `initialPageStatusCode` (object)

  - `initialPageStatusCode.negated` (boolean, required)
    Switches from  to , and from  to

  - `finalPageStatusCode` (object)

  - `combinedPageStatusCode` (string)
    -  - initial or final URL are ,
-  - initial URL is  or  and final URL is
    Enum: "broken", "good"

  - `pageLoadTime` (object)
    Page load time in milliseconds. Should have  and/or  properties defined.  is inclusive and  is exclusive.  should be less than .

  - `pageLoadTime.min` (integer)

  - `pageLoadTime.max` (integer)

  - `pageSize` (object)
    Page size in bytes. Should have  and/or  properties defined.  is inclusive and  is exclusive.  should be less than .

  - `redirectCount` (object)
    Number of redirects for a page. Should have  and/or  properties defined.  is inclusive and  is exclusive.  should be less than .

  - `hasBrokenLinks` (boolean)

  - `pageUrlMatchingAuditFilterConfiguration` (boolean)

  - `primaryTagsOnly` (boolean)
    if true then return only pages/tags with primary tags else return all pages/tags

  - `tagId` (integer)
    Tag ID

  - `tagCategoryId` (integer)
    Tag category ID

  - `tagVendorId` (integer)
    Tag vendor ID

  - `tagAccount` (string)
    Tag account

  - `pagesWithoutTagCategoryId` (integer)
    Tag category ID

  - `pagesWithoutTagVendorId` (integer)
    Tag vendor ID

  - `pagesWithoutTag` (object)

  - `pageStatusCode` (string)
    good - 2xx, redirects - 3xx, broken - all others
    Enum: "good", "redirects", "broken"

  - `pagesWithoutTagId` (integer)
    Deprecated in favour of

## Response 200 fields (application/json):

  - `metadata` (object, required)
    Common metadata for iterable

  - `metadata.pagination` (object, required)

  - `metadata.pagination.totalCount` (integer, required)
    Total number of items available from all result pages combined

  - `metadata.pagination.totalPageCount` (integer, required)
    Total number of pages available

  - `metadata.pagination.pageSize` (integer, required)
    Page size - number of items per result page configured by  query parameter or default page size

  - `metadata.pagination.currentPageSize` (integer, required)
    Number of items in current result page

  - `metadata.pagination.currentPageNumber` (integer, required)
    Current page number/ordinal

  - `pages` (array, required)

  - `pages.pageId` (string, required)
    Example: "f9d32cc7cc2046d6decb145a80289287f5226323"

  - `pages.pageUrl` (string, required)
    Example: "https://example.com/about"

  - `pages.pageLoadTime` (integer, required)
    Time page took to load, in milliseconds

  - `pages.pageStatusCode` (integer, required)
    Page HTTP status code

  - `pages.finalPageUrl` (string)
    Example: "https://example.com/about"

  - `pages.finalPageStatusCode` (integer)
    Page HTTP status code

  - `pages.tagInstanceCount` (integer, required)
    Number of tag requests on a page

  - `pages.uniqueTagCount` (integer, required)
    Number of unique tag vendors discovered on a page

  - `pages.brokenTagCount` (integer, required)
    Number of broken tag requests on a page

## 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)