# Get a list of Tripwire alerts

Endpoint: GET /tripwire-alerts
Version: 1.2
Security: bearerAuth

## Query parameters:

  - `page` (integer, required)
    Page of results to show
    Example: 1

  - `pageSize` (integer, required)
    Results to return per page
    Example: 100

  - `sort` (string)
    Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change
    Example: "id,name | name:desc"

  - `fields` (string)
    Comma-delimited list of the field(s) to return if only a subset is required
    Example: "id,name"

  - `triggeredDate` (string, required)
    Filter by the triggered alert date and time
    Example: "xyz | in:x,y | like:xyz"

  - `planId` (string)
    Filter by Tripwire plan identifier
    Example: "xyz | in:x,y | like:xyz"

  - `analysisLevel` (string)
    Filter alerts by analysis level
    Example: "UPI_ROLLING_24HRS"

  - `thresholdQuantity` (string)
    Filter alerts by the quantity threshold
    Example: "xyz | in:x,y | like:xyz"

  - `thresholdPrice` (string)
    Filter alerts by the major currency value threshold
    Example: "xyz | in:x,y | like:xyz"

  - `thresholdCallCount` (string)
    Filter alerts by the call count threshold
    Example: "xyz | in:x,y | like:xyz"

  - `productReference` (string)
    Filter alerts by product reference
    Example: "xyz | in:x,y | like:xyz"

  - `customerId` (string)
    Filter alerts by customer identifier
    Example: "xyz | in:x,y | like:xyz"

  - `siteId` (string)
    Filter alerts by site identifier
    Example: "xyz | in:x,y | like:xyz"

## Response 200 fields (application/json):

  - `id` (integer)
    Alert identifier
    Example: 1

  - `triggeredDate` (string)
    Example: "2022-01-01T00:00:00Z"

  - `planId` (number)
    Tripwire plan identifier

  - `planRuleName` (string)
    Tripwire plan rule description
    Example: "Daily calls exceeding £10.00"

  - `analysisLevel` (string)
    Tripwire analysis level used to determine ratedValueBefore/AfterDiscount (see TripwireAlert object)
    Enum: "UPI_ROLLING_24_HOUR", "UPI_OPEN_BILL_RUN", "SINGLE_CALL"

  - `thresholdQuantity` (integer)
    Threshold quantity value
    Example: 5

  - `thresholdPrice` (number)
    Threshold price in major currency (e.g. pounds/dollars/euros)
    Example: 10

  - `thresholdCallCount` (integer)
    Threshold call count value
    Example: 15

  - `ratedValueBeforeDiscount` (number)
    Rated value in major currency before applying discounts (used by UPI_ROLLING_24HRS)
    Example: 25.25

  - `ratedValueAfterDiscount` (number)
    Rated value in major currency after applying discounts (used by OPEN_BILL_RUN & SINGLE_EVENT)
    Example: 15.25

  - `totalCallCount` (integer)
    Total call count value
    Example: 15

  - `productReference` (string)
    Product reference

  - `customerId` (number)
    Customer identifier
    Example: 1234

  - `siteId` (number)
    Site identifier
    Example: 1234


## Response 400 fields

## Response 401 fields

## Response 403 fields