> For the complete documentation index, see [llms.txt](https://docs.craft.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.craft.co/alerts-api/alerts-api-reference.md).

# Alerts API Reference

The [Alerts API](/alerts-api/intro.md) provides two top-level nodes for Craft API: `alerts` and `alert`. 

### Alerts node signature

Returns a subset of Alerts as per specified arguments. The default page size is 100 items. Items are sorted by the `publishedAt` field in descending order by default.

| Argument | Type                                                                                         | Description                                                                | Default          |
| -------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------- |
| first    | Int                                                                                          | The number of Alerts to retrieve. Should be between 1 and 100 if specified | 100              |
| after    | ID                                                                                           | When specified, API will return the next page of Alerts after given ID     |                  |
| where    | [AlertBoolExpression](/alerts-api/alerts-api-reference/filter-object.md#alertboolexpression) | An expression defining a subset of Alerts to be returned from the API      |                  |
| orderBy  | AlertOrderBy                                                                                 | Specifies fields and sorting order for the API output                      | publishedAt DESC |

### Alert node signature

Allows retrieving a single Alert by its ID.

| Argument | Type | Description                                      | Default |
| -------- | ---- | ------------------------------------------------ | ------- |
| id       | ID   | Unique ID of Alert, as retrieved from Alerts API |         |