# Search target items (data sources - audits, journeys etc) that may have specified Alert assigned or not assigned

POST /v3/alerts/target-items/{itemType}/search

Endpoint: POST /v3/alerts/target-items/{itemType}/search
Security: API_Key

## Path parameters:

  - `itemType` (string, required)
    Enum: "AUDIT", "WEB_JOURNEY"

## Query parameters:

  - `size` (integer)

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

  - `sortBy` (string)
    Enum: "IS_ASSIGNED", "ITEM_NAME", "RUN_DATE"

  - `sortDesc` (boolean)
    Controls sorting order

## Request fields (application/json):

  - `alertId` (integer)

  - `assignedToAlert` (boolean)
    if  is NOT specified,  is ignored.
if  IS specified  has 3 states:
when TRUE - only items assigned to the specified alert will be returned;
when FALSE - only NOT assigned;
when NOT specified or NULL - both assigned and not assigned items will be returned

  - `itemName` (string)
    optional "item name contains substring" filter

  - `itemId` (integer)
    ID of the item that can have assigned Alert(s) onto it. See also

  - `itemLabels` (array)
    non-empty array of labels present on an item, works as "item has all specified labels" filter

  - `folders` (array)
    non-empty array of folders with domains (subfolders), items from which will be included in response

  - `folders.folderId` (integer, required)
    ID of a folder
    Example: 123

  - `folders.domains` (array)
    null or empty array of domains (subfolders) present on an item, works as "null or empty if entire folder (all domains in a folder), otherwise specific domain IDs"
    Example: [123]

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

  - `items` (array, required)

  - `items.isAssigned` (boolean, required)
    TRUE if Alert is assigned to this item, FALSE otherwise

  - `items.itemType` (string, required)
    Enum: "AUDIT", "WEB_JOURNEY"

  - `items.itemId` (integer, required)
    ID of the item that can have assigned Alert(s) onto it. See also

  - `items.itemName` (string, required)
    Name of audit/WJ etc

  - `items.itemLastRunAt` (string)
    Date-time in [RFC3339 profile ISO 8601 format](https://www.ietf.org/rfc/rfc3339.txt) with
the following additional restrictions:
1. An uppercase T must separate the date and time portions.
2. An uppercase Z must denote that a numeric time zone offset isn't present.

In general, these timestamp requirements are the same in
[AWS Step Functions - Choice Rules](https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-choice-state.html)
    Example: "2016-08-18T17:33:00Z"

  - `items.itemLabels` (array)
    may be absent if item does not support labels

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