---
title: "List Alerts"
method: GET
path: "/v1/merchant/alerts"
tags: ["Merchant API"]
---

# List Alerts

`GET /v1/merchant/alerts`

## Request

- Base URL: `http://{{base_url}}`
- URL: `http://{{base_url}}/v1/merchant/alerts`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/docs/v1/merchant/alerts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all outstanding alerts for this merchant.

### Filters
All filters should be passed in the URL as GET arguments.

|    Argument    |    Description    |
|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|    include_dismissed    |    Y or N. Default N. If Y, Alerts that are no longer active will also be returned    |


### Array Response Fields
|    Field    |    Data Type    |    Length    |    Description    |
|---------------------|-----------------|--------------|---------------------------------------------------------------------------|
|    notification_pk    |    Int    |        |    Unique identifier for this alert     |
|    first_datetime    |    Timestamp    |         |    Time error first occurred    |
|    last_datetime    |    Timestamp    |         |    Time error most recently occurred or was resolved    |
|    subject    |    String    |         |    Alert subject line / Summary   |
|    message    |    String    |         |    Alert message details. May contain newline characters "\n"   |
|    error_type    |    String    |         |   Which process failed. Eg: INVENTORYUPLOAD, ORDERDOWNLOAD, WMSORDERSEND, SHIPCONF    |
|    error_id    |    String    |         |   Specific record that failed. Could be an order number or a product sku    |
|    duplicates    |    Int    |         |   Count of number of times this exact error occurrend    |
|    order_source    |    String    |         |   Order Source name of affected cart. Blank if this not a cart level error.     |
|    dismissed_sw    |    Boolean    |         |    true if alert has already been dismissed    |
|    resolved_automatically    |    Boolean    |     |    true if system auto-resolved this alert. For this to be true, dismissed_sw must also be true    |

## Response `200`

OK

- object

---

[API](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover.md) - [All operations](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/llms.txt) - [OpenAPI document](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/revisions/125e6deac675?raw)