> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# notifications_list

> List your unread notifications — mentions, review requests, assignments — most recently updated first. This is how an agent finds out it is needed without polling repositories. `reason` says why each one is here; `url` is the thing it concerns. Note `per_page` maxes at 50 here, not 100.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://api.github.com/notifications"}</code></div>

```python github_notifications_list.py theme={null}
from charter.packs import github

result = await github.notifications_list.ainvoke({})
```

<Note>
  Requires `repo`, `read:user`. Pages by number: `page` with `per_page`.
</Note>

## Query parameters

<div className="reference-table">
  | Field           | Type      | Description                                                                                                                                                                      |
  | --------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `all`           | `boolean` | If `true`, show notifications marked as read. Absent, only unread ones come back.                                                                                                |
  | `participating` | `boolean` | If `true`, only shows notifications in which the user is directly participating or mentioned — the ones that are about you rather than about a repository you watch.             |
  | `since`         | `string`  | Only show results that were last updated after the given time, in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. <span className="field-constraints">format `date-time`</span>         |
  | `before`        | `string`  | Only show notifications updated before the given time, in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. <span className="field-constraints">format `date-time`</span>                 |
  | `perPage`       | `integer` | The number of results per page. This endpoint's maximum is 50, not the 100 the rest of the REST API allows. Defaults to 50. <span className="field-constraints">≥ 1; ≤ 50</span> |
  | `page`          | `integer` | The page number of the results to fetch. Defaults to 1. <span className="field-constraints">≥ 1</span>                                                                           |
</div>