# Get request initiators info for a given page

POST /v3/web-audits/{auditId}/runs/{runId}/pages/{pageId}/initiators

Get request initiators info for specified audit run page

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

  - `pageId` (string, required)
    Unique identification number for web audit run-page, it is different from dcUUID
    Example: "f9d32cc7cc2046d6decb145a80289287f5226323"

## Request fields (application/json):

  - `tagsOnly` (boolean)
    If set then return only tags, else ignored

  - `primaryTagsOnly` (boolean)
    If set then return only primary tags, else ignored

  - `tagId` (integer)
    Tag ID

  - `tagAccount` (string)
    Tag account

  - `tagVendorId` (integer)
    Tag vendor ID

  - `tagCategoryId` (integer)
    Tag category ID

  - `withCookiesOnly` (boolean)
    If set then return only requests that specified cookies, else ignored

  - `cookieName` (object)

  - `cookieName.filterType` (string, required)
    Enum: "contains", "not_contains"

  - `cookieName.filterValue` (string, required)

  - `cookieDomain` (object)

  - `partyType` (string)
    Indicates if cookie domain is different from domain of a page it was set on. 
owned_3rd_party is deprecated
    Enum: "1st_party", "owned_3rd_party", "3rd_party"

  - `requestUrl` (object)

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

## Response 200 fields (application/json):

  - `initiatorsSummary` (object, required)

  - `initiatorsSummary.totalNetworkRequestCount` (integer, required)

  - `initiatorsSummary.filteredNetworkRequestCount` (integer, required)

  - `initiatorsSummary.totalBrokenNetworkRequestCount` (integer, required)

  - `initiatorsSummary.filteredBrokenNetworkRequestCount` (integer, required)

  - `initiatorsSummary.totalTagCount` (integer, required)

  - `initiatorsSummary.filteredTagCount` (integer, required)

  - `initiatorsSummary.totalCookieCount` (integer, required)

  - `initiatorsSummary.filteredCookieCount` (integer, required)

  - `initiatorsTreeRoot` (object, required)
    Represents a node in the initiators tree. 
Each node/vertex is a network request. 
The root node is the page request.
The root node does not have relationToParent
Leaf nodes are requests that have no children.
To get information about specific nodes use POST /v3/web-audits/{auditId}/runs/{runId}/pages/{pageId}/initiators/request-log endpoint with harEntryIndices specified

  - `initiatorsTreeRoot.harEntryIndex` (integer, required)
    The 0-based index of the HAR entry that this request corresponds to. Used to uniquely identify a request on a page.

  - `initiatorsTreeRoot.relationToParent` (string)
    Default value is normal, may be omitted.
The root node does not have relation.
    Enum: "normal", "weak"

  - `initiatorsTreeRoot.children` (array, required)
    When filters applied, only the following nodes are retained in the children array: 
- leaf nodes matching filters,
- intermediate nodes matching filters,
- intermediate nodes not matching filters but having successors matching filters.

  - `initiatorsTreeRoot.originalSubtreeSize` (integer, required)
    Total number of nodes under the current node (including its children, grand-children and so on)

  - `initiatorsTreeRoot.filteredSubtreeSize` (integer, required)
    Number of nodes under the current node (including its children, grand-children and so on) after filtering

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