# List alerts

Returns alerts, most recent first. An alert is raised on a customer when something needs attention, such as a drop in usage, and stays open until a member completes or dismisses it. Each comes with the playbook to follow, if it has one, whether the member has saved it, and how many comments it has; read them with list_alert_comments. Give a customer for its alerts, or leave it out for alerts across the member’s customers.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "customer": {
      "description": "Only alerts for this customer, by name or ID",
      "type": "string",
      "minLength": 1
    },
    "scope": {
      "default": "mine",
      "description": "Ignored when a customer is given. mine: customers the member is assigned to. team: customers the member or their team is assigned to. all: every customer the member can see",
      "type": "string",
      "enum": [
        "mine",
        "team",
        "all"
      ]
    },
    "status": {
      "default": "open",
      "description": "Which alerts to return. saved is the open alerts the member has saved",
      "type": "string",
      "enum": [
        "open",
        "saved",
        "completed",
        "dismissed"
      ]
    },
    "limit": {
      "default": 10,
      "description": "How many to return, up to 100. Ask for more only if the first results were not enough",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "How many to skip from the start of the list. To continue a list, give how many have been returned so far",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "additionalProperties": false
}
```

